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Revision History 


Version 

Date 

Description 

1.4 

2009/01/29 

• Corrected typos in Figures 3-1,3-5, and 3-9. 

1.3 

2008/12/19 

• Added a line in Figure 1-1 to connect the ARM7 bus and external memory 

Interface. 

• Corrected error In DMA transfer speed from VRAM to main memory In Table 3-6. 

• Corrected cycle count In Figure 3-1. 

• Added cycles which include termination to Figures 3-3, 3-5, 3-7, 3-9, and 3-11. 

• Added Figures 3-4, 3-8 and 3-12 (Worst-case transfer sequence diagrams). 

• Added notes concerning the Display Selection Flags to the description of the 
Dlsolav Control Realsters In Chaoter 6. The notes describe the delav from the time 
a flag Is set until display Is enabled. 

• Added supplementary explanation of the excecutlon cycle count for geometry 
commands In Chaoter 7. 

• Added Information concernlno the camera anale of view to Chaoter 21 . Chanoed 
“focal length” to “depth of field.” 

• Added a note to Chapter 23 concerning waits when reading. 

1.2 

2008/10/31 

• Replaced one Instance of the Nintendo racetrack logo and deleted several others. 

• Revised some addresses in Figure 1-2. 

• Revised the palette data In Appendix C and added a note. 

1.1 

2008/10/27 

• Revised the Nintendo racetrack logo. 

• Revised the color data format In section 6.5, and added a note. 

• Revised the text In section 17.1.4, “Microphone Input Values.” 

• Revised the abbreviation for “command” from “COM” to “CMD in Chapter 22, 

“DSP.” 

1.0 

2008/10/01 

• Initial version. 
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About the Notation Used in This Programming Manuai 


Registers 

Detailed classifications are shown at the top of the register, whiie broader ciassifications are shown on the 
bottom. If text does not fit, then the description is shown beiow the register, as shown with the “enabie fiag” 
in the exampie beiow. Notation such as “d15” is used to refer to a specific bit (in this case the highest-order 
bit in a 16-bit register). 


Example: TWL Register 

Name: TWL Address: 0x04000??? Attribute: RA/V Initial value: 0x0000 


15 __^___ 8 I 7 ___0 


El 

EO 






BLUE 

GREEN 

RED 



Image mode 




Color 


^ Enable flag 


Bit lengths 

Bit iengths for bytes, haif-words, and words are defined as foiiows: 

8-bit: Byte 
16-bit: Haif-word 
32-bit: Word 

Endian 

TWL adopts the little-endian method. Therefore, in a 16-bit register, the address for d15-d08 is one more 
than the address for d07-d00. 


16-bit register Memory map 


1_ 1 

1 _1 

□ 


□ 

□ 

□ 

□ 

□ 

□ 

□ 


□ 

□ 


□ 

□ 

□ 

d15-d08 

d07-d00 
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1 System 

1.1 System Outline 

The overall TWL system block diagram Is shown In Figure 1-1. 

Figure 1-1 : Overall System Block Diagram 
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1.1.1 TWL Processor 

The TWL processor is a combined chip that inciudes both memory and TWL features such as ARM9 and 
ARM7 CPU cores, a DSP core, and 2D and 3D graphics engines. 

The specifications of the TWL processor are as foiiows: 

• The CMOS Muiti CPU 


Main processor core 
Subprocessor core 
DSP core 


ARM946E-S (134.056 MHz / 67.028 MHz) 
ARM7TDMI (33.514 MHz) 

TeakDSP (134.056 MHz / 67.028 MHz / 33.514 MHz) 


The operating frequency of the main processor core can be changed in the system configuration. 

• Compatibiiity 

Switches between TWL mode and NITRO compatibiiity mode. 

(The AGB compatibiiity mode that was supported on NITRO is no ionger avaiiabie.) 

• Graphics Engines 


2D Graphics Engines A and B 33.514 MHz 




33.514 MHz 


Geometry Engine 

Maximum 4 million vertices per second 

4x4 matrix computation 

6-plane clipping 

Lighting (4 parallel light sources) 

Matrix stack 

Texture coordinate conversion 

Box culling test 



33.514 MHz 

Maximum 120 thousand polygons per second 

Maximum 30 million pixels per second 

3D Graphics Engine 


Triangular and quadrilateral rendering 

Texture format 



4-, 16-, and 256-color palette formats 

Bitmap format 

4x4 texel compression format 


Rendering Engine 

Translucent (A3I5, A5I3) fermat 

Texture size 

8x8 to 1024x1024 

Alpha blending 

Alpha test 

Feg 

Toon shading 

Edge marking 

Anti-aliasing 


Revisions to the circuits for each engine can be enabied or disabied using the system configuration. 
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• LCD Controller (built-in for two LCDs: the upper and iower screens) 


Display Size 256 x 192 x RGB dots 

Display Colors 262,144 colors (R:G:B = 6:6:6) 


Dot Clock 


5.586 MHz 


• Memory 


System ROM 

ARM9: For TWL: 64 KB (16K x 32 bit) 

For compatablllty : 8 KB (2K x 32 bit) 

ARM7: For TWL: 64 KB (16K x 32 bit) 

For compatibility : 16 KB (4K x 32 bit) 

TWL Processor 

Internal Work RAM 

ARM9, ARM7 shared : 32 KB (8K x 32 bit) + 

256 KB(16Kx32 bit x 4) 

ARM7 dedicated : 64 KB (16K x 32 bit) 

ARM9, ARM7, DSP instruction RAM shared : 256 KB (8K x 32 bit x 8) 

ARM9, ARM7, DSP data RAM shared : 256 KB (8K x 32 bit x 8) 

VRAM 

Total of 656 KB 

(128 KB + 128 KB + 128 KB + 128 KB + 64 KB + 16 KB + 16 KB + 32 KB + 16 KB) 
(Each VRAM can support 0 wait state access and byte write operations) 

System Clock 

33.514 MHz 

Sound 


ADPCM/PCM 16 channels (up to 6 channels for the PSG sound source and up to 2 channels for noise) 
The TWL inciudes sound capture capabiiities (used for reverb, etc.). 

Mixing with DSP sound is possibie. 

• Timers 

ARM9 : 16-bit timer x 4 
ARM7 : 16-bit timer x 4 

• DMA 

ARM9 : 4 channei x 2 

ARM7 : 4 channei x 2 -i- Sound DMA features 


There is a NITRO-compatibie DMA controiier, as weii as a new DMA controiier that can perform biock 
transfers and aiiows you to choose the arbitration poiicies. Revisions to the circuits for the NITRO- 
compatibie DMA controiier can be enabied or disabied using the system configuration. 

• Acceierator 


Divider (Revisions to the divider circuit can be enabied or disabied using the system configuration.) 
Square root unit 

• Externai Memory Interface 

The TWL includes one slot for the TWL/DS Game Card interface (which adds card detection and hot 
swapping features) and one slot for the SD Card interface. (The Game Pak interface for AGB 
compatibility is no longer available.) 

• NAND Flash Memory 

The TWL includes 256 MB of NAND Flash memory. 
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• Camera 

Supports capturing at 20 frames/second at VGA size or 30 frames/second at QVGA size. 

Inciudes a YUV to RGB conversion circuit (RGB555 format) and a trimming feature. 

1.1.2 Main Memory 

The main memory is 16 MB (expanded to 32 MB for TWL Debugger) and is connected to the TWL 
processor as an independent chip. When the system configuration are configured to NITRO compatibiiity 
mode, the memory is iimited to 4 MB. 

Because the TWL/NITRO card bus is not mapped to the CPU address space, appiications and data must 
be executed after ioading them into main memory. 

ARM9 appiications are transmitted from the TWL/NITRO card to main memory by system ROM at startup. 
ARM7 appiications are transmitted to the ARM7 dedicated work RAM at startup. 

1.1.3 LCD 

There are two LCD screens, an upper screen and a iower screen. 

An overview of both LCD screen specifications is shown in Tabie 1 -1. 


Table 1-1 : Overview of LCD Screen Specifications 


Features 

Details 

Display Resolution 

256 X 192 pixels (Ratio 4:3) 

Number of 
Displayable Colors 

262,144 colors (RGB=6:6:6) 

Screen Size 

3.25 Inches 

Type 

Transmissive 

Backlight 

Can be switched ON and OFF. 

Five steps of brightness can be 
adjusted via the IPL console 
configurations. 


The main specifications are the same as the Nintendo DS Lite with the exception of the screen size and 
the number of brightness ieveis, but it is aiso possibie to automaticaiiy controi the screen to show either 
biack or white when the power is turned off. 

1.1.4 Digital Keys 

The digitai keys are START, SELECT, the + Keypad, A, B, X, Y, L, and R. 

1.1.5 Touchscreen 

The entire iower screen LCD is a resistive membrane touch panei that can obtain pixei-unit coordinates. 
The TWL system comes equipped with a standard styius. 

1.1.6 Microphone 

Either the Nintendo DS Series Headset or the buiit-in omnidirectionai condenser microphone can be used. 
Sound input from the microphone can be sampied. 
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1.1.7 RTC 

The RTC keeps real time and handles timekeeping operations. 

With the supported aiarm feature, the RTC can wake up the TWL from Sieep Mode at a specified time. 

1.1.8 Wireless Communications 

The TWL inciudes two on-board wireiess communications units capabie of using the 2.4-GHz band. The 
foiiowing modes are avaiiabie with the NITRO-compatibie unit (NITRO wireiess): 

• Infrastructure Mode (Internet play) that allows connections to wireless LAN (IEEE 802.11b/g) access 
points 

• Multi-Card Play that enables communications with up to 16 DS devices 

• Single-Card Play that downloads games from a parent device to child devices that are not equipped 
with DS Game Cards 

With the TWL wireless unit, only Infrastructure Mode (IEEE 802.1 Ib/g) can be used, but the connections 
are faster and more secure than with the NITRO wireless unit). 

1.1.9 TWL/NITRO Game Cards 

A TWL/NITRO Game Card is a game card with TWL/NITRO-exclusive security features. A backup device 
can be included in addition to the ROM. 

The TWL/NITRO Game Card is connected to the TWL processor via an external memory interface. For 
more information, refer to the Nintendo DS/TWL Game Card Manual. 

1.1.10 Game Paks 

AGB-compatibility mode, which was supported on NITRO, is no longer supported. When in NITRO 
compatibility mode, attempting to access a Game Pak will yield the same behavior as if no Game Pak were 
inserted. 

1.1.11 SD Cards 

The TWL includes one SD Card slot that can read SD (Secure Digital) Cards and SDHC (SD High Capac¬ 
ity) Cards with capacities between 2 and 32 GB. It does not support SPI mode, encrypted authentication 
(CPRM), or High-Speed mode. 

1.1.12 NAND Flash Memory 

TWL includes 256 MB of NAND Flash memory. 

NAND Flash memory is used for saving NAND applications, saving the save data for NAND applications 
(including the system applications), and for saving photo data. 

1.1.13 Camera 

The camera can capture movies at 20 frames/second at VGA (640x480) size, or 30 frames/second at 
QVGA (320x240) size. 

1.1.14 DSP (Digital Signal Processor) 

The DSP accelerates image and sound processing. By using the work RAM, data processed by the DSP 
can be shared by the ARM9 and the ARM7. In addition, is also possible to mix the output from the sound 
circuit with sounds generated by the DSP and output the result. 
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1.2 Memory Map 

The overall memory maps for the ARM9 and ARM7 on the production version of the TWL are shown In 
Figure 1-2. The yellow areas In the memory map Indicate differences with the NITRO specifications, and 
the magenta areas Indicate brand new portions that were added for TWL. 

The access attributes for the ARM9 memory space are determined by the configuration of the protection 
units. 

For more details, see "4.1 Protection Unit" on page 59 . 

• About the Image 

A decoder converts the address output by the CPU to a memory address. 

Because the decoder does not normally decode all the address bits, when an address that Is not 
mounted In memory Is accessed. It Is converted to the address of the memory located closest to the 
smallest part of the address. (See the note below.) 

Images are regions of the memory map that appear where nothing normally exists (regions differ from 
the physical memory). 

Even If the address Is different on the CPU, the address Is the same In memory. Therefore, accessing 
an Image Is the same as accessing the physical memory. Furthermore, when the Image region Is 
larger than the memory size, an Image the same size as the physical memory Is repeated. 

For example, the BG-VRAM physical memory for 2D Graphics Engine A occupies the 512 kilobytes In 
the 0x06000000 - 0x0607FFFF section In the Memory Map, but the Image region occupies the 1536 
KB of the 0x06080000 - 0x061 FFFFF section, so there are three Images. 

Note: There Is some freedom In where the shared ARM9 and 7 Internal work RAM can be physically 
positioned, as long as It Is kept In the range 0x03000000-0x03FFFFFF. 

In addition, there are regions of undefined data that have no Image (see Figure 1-2). 

Note: Do not access the undefined data. 
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Figure 1-2 : ARM9 and ARM7 Overall Memory Maps 


ARM9 Overall Memory Map 

ARM7 Overall Memory Map 

OxFFFFOOOO 

System ROM (64 KB) 

OxOEOOOOOO 

Undefined Data 

OxOEOOOOOO 

Undetined Data 

OxODOOOOOO 

[Watti Memory (16'MB when expanded) 

OxODOOOOOO 

Main Memory (16 MB when expanded) 

OxOCOOOOOO 

IMain Memory Image (16 MB) 

OxOCOOOOOO 

Main Memory Image (16 MB) 

OxOAOIOOOO 

Undefined Data 

OxOAOIOOOO 

Undefined Data 

OxOAOOOOOO 

Game Pak RAM (0-64 KB) (see note) 

OxOAOOOOOO 

Game Pak RAM (0-64 KB) (see note) 

0x08000000 

Game Pak ROM (32 MB) (see note) 

0x08000000 

Game Pak ROM (32 MB) (see note) 

0x07000800 

OAM Image 

0x07000000 

Undefined Data 

0x07000400 

2D Graphics Engine B OAM (1 KB) 

0x07000000 

2D Graphics Engine A OAM (1 KB) 

0X068A4000 

VRAM Image for LCDC 

0x06040000 

Internal Expanded Work RAM Image 

0x06800000 

VRAM for LCDC (656 KB) 

0x06620000 

OBJ-VRAM Image 

0x06600000 

2D Graphics Engine B 

OBJ-VRAM (max.128 KB) 

0x06440000 

OBJ-VRAM Image 

0x06400000 

2D Graphics Engine A 

OBJ-VRAM (max. 256 KB) 

0x06220000 

BG-VRAM Image 

0x06200000 

2D Graphics Engine B 

BG-VRAM (max. 128 KB) 

0x06080000 

BG-VRAM Image 

0x06000000 

2D Graphics Engine A 

BG-VRAM (max. 512 KB) 

0x06000000 

Internal Expanded Work RAM 
(max. 256 KB) 

0x05000800 

Palette RAM Image 

0x04810000 

Undefined Data 

0x05000600 

2D Graphics Engine B 

Palette RAM for OBJ (512 B) 

0x05000400 

2D Graphics Engine B 

Palette RAM for BG (512 B) 

0x05000200 

2D Graphics Engine A 

Palette RAM for OBJ (512 B) 

0x05000000 

2D Graphics Engine A 

Palette RAM for BG (512 B) 

0x04000000 

I/O Registers (see note) 

0x04808000 

Wireless Communications Wait State 1 

0x04800000 

Wireless Communications Wait State 0 

0x04000000 

I/O Registers (see note) 

0x03800000 

ARM9, 7 Shared Internal Work RAM Image 

0x03810000 

ARM7 Dedicated Internal Work RAM Image 

0x03800000 

ARM7 Dedicated Internal Work RAM (64 KB) 

0x03738000 

AKM9, / Shared Internal Work RAM (max. 
800 KB) 

0x03738000 

ARM7, 9 Shared Internal Work RAM (max. 

800 KB) 

0x03000000 

ARM9, 7 Shared Internal Work RAM Image 

0x03000000 

ARM7, 9 Shared Internal Work RAM Image 

0X02FE0000 

Data TCM (16 KB): Moveable (see note) 

0x02000000 

Main Memory (16 MB) 

0x02000000 

Main Memory (16 MB) 

0X01FF8000 

Instruction TCM (32 KB) 

0x00010000 

Undefined Data 

0x01000000 

Instruction TCM Image 

0x00000000 

Undefined Data 

0x00000000 

System ROM (64 KB) 


Note: The I/O registers are different on ARM9 and ARM7. 

Note: The Data TCM can be moved around, so the address in the figure above is just an example. 

Note: The Game Pak region can be accessed, but write operations will be ignored, and reads will return fixed values. 
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1.3 Accessing Devices Connected to the Subprocessor 

On TWL, as with NITRO, you must use the API to access devices connected to the subprocessor. 

By using the API, you can access the device, regardiess of what state the subprocessor is in. 

The foiiowing devices connect to the subprocessor: wireiess communications, a portion of the digitai keys, 
the sound. Touch Screen, microphone, RTC, buiit-in fiash memory, SD Card, NAND fiash memory, and the 
AES encryption/decryption circuit. 

• What is an API? 

An Application Program Interface (API) is a group of functions that increase efficiency when 
deveioping appiications. In general, the API is used in low-level system calls and to control hardware. 

Note: It is possible to access the registers related to the interface with the ARM7 subprocessor in ARM9, 
but these registers should not be accessed if using the API. 

1.4 Startup Mode 

Choose one of the following modes for the operation of your application. The mode is determined when the 
application is created and cannot be changed thereafter. 

1.4.1 TWL Mode 

In this mode, all TWL features can be used. 

1.4.2 NITRO Compatibility Mode 

In this mode, compatibility with NITRO is maintained. 

Note: Because the AGB Game Pak slot has been eliminated, attempting to access a Game Pak will yield 
the same behavior as if no Game Pak were inserted. The method of sound output has also been 
changed. 

1.5 Markets 

As shown in Table 1-2, there are four TWL system configurations, depending on the market. 

Table 1-2 : Differences in TWL Systems by Market 


Market 

Configurable 

Languages 

Available Banner Font 

Japan(JP) 

Japanese 

Hiragana, Katakana, Alphabetical, Signed 
Alphabetical, Numeric, etc. 

North America (US) 

English, French, Spanish 

Same as above 

Europe (EU) 

English, French, Spanish, 
German, Italian 

Same as above 

Australia (AU) 

English 

Same as above 


Note: With NITRO, the same systems were used for all regions (Japan, North America, Europe, and 
Australia), and the user could freely change which language was used. With TWL, there are four 
types of TWL systems (one for each region), and the languages that can be selected are different 
for each region as shown in Table 1-2. 
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2 Differences from NITRO 

TWL is compatible with NITRO, but there are a number of differences between TWL and NITRO. For 
example, new modules have been added, the Game Pak slot has been eliminated, and it is possible to use 
circuits that correct hardware bugs. This chapter summarizes the differences between TWL and NITRO 
and explains the system configuration used to manage the modules used with TWL. 

2.1 Newly Added Modules 

The newly added modules are the camera, DSP, new shared WRAM, new DMA, new wireless LAN (TWL 
wireless), SD Card, NAND flash memory, and the AES encryption/decryption circuit. Among these, the 
new wireless LAN (TWL wireless), SD Card, NAND flash memory, and AES encryption/decryption circuit 
are connected to the subprocessor, so they can only be operated through the API. 

2.2 Game Pak Slot 

The Game Pak slot has been eliminated, but no changes have been made to the registers or the 
addresses it is mapped to. It is also possible to use these registers as the trigger to recover from sleep 
mode. However, writing is disabled for the addresses that the Game Pak slot is mapped to, and the data 
that is read from these registers will always be 0. Additionally, if the Game Pak IREQ/DREQ interrupt 
permission flag is set to 1, it will not be possible to transition to sleep mode. 

2.3 Changed Modules 

The analog-digital conversion that was previously performed with PMIC on NITRO is now handled by a 
module called “CODEC,” and the specifications for the mixer output and microphone input have changed 
(no changes have been made to the sound circuit itself). For details on the mixer, see " 14.1.3 Mixer " on 
page 334. For details on the microphone, see " 17 Microphone " on page 353. 

2.4 System Configuration 

In TWL mode, it is possible to control both the provision of clock signals and access to the newly added 
modules by means of the system configuration registers (SCFG_*). 

2.4.1 System ROM 

The register below lets you look up the status of the system ROM used by the ARM9. 

System Configuration: ROM Status Register 

Name Address Attribute Initial Value 

SCFG A9ROM 0x04004000 R 0x0000 


15 8 7 1 0 



STATUS 




Status Flag 


• STATUS[d01-d00] : Status Flag 


00 


NITRO compatibility mode 
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01 


TWL mode 


These bits are intended for reading the vaiues configured in the subprocessor, so they cannot be 
written to. 

2.4.2 New Block Clock Control 

The register beiow controis the provision of a ciock signai to the camera, new shared WRAM, and the DSP, 
and aiso controis the operating frequency of the ARM9. 

System Configuration: New Biock Ciock Controi Register 

Name Address Attribute Initial Value 

SCFG CLK 0x04004004 R/W 0x0084 


15 

8 

7 

2 

1 

0 


CAM 

CKI 

WRAM 

HCLK 


CAM 

HCLK 

DSP 

HCLK 

CPU 

SPD 









External Clock Control for the Camera 


Camera Interface Block Clock Control 


Block Clock Control for New 
Shared WRAM 


DSP Block Clock Control 


ARM9 CPU Operating Frequency 


• CAMCKI[d08] : Externai Ciock Controi for the Camera 


0 

Disable 

1 

Enable (Outputs at 16.76 MHz) 


• WRAMHCLK[d07] : Biock Ciock Controi for New Shared WRAM 


0 

Stop clock 

1 

Provide clock 


These bits are intended for reading the vaiues configured in the subprocessor, so they cannot be 
written to. 

• CAMHCLK[d02] : Camera Interface Biock Ciock Controi 


0 

Stop clock 

1 

Provide clock 


• DSPHCLK[d01 ] : DSP Biock Ciock Controi 


0 

Stop clock 

1 

Provide clock 


• CPUSPD[d00] : ARM9 CPU Operating Frequency 


0 


Same as NITRO (67.03 MHz) 
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1 2x Speed Operation (134.06 MHz) 

To be safe, only stop the clock after each of the modules has been stopped. 

When changing the operating frequencing of the ARM9, overwrite the bit from the program in ITCM, and 
then iet a minimum of 8 cycies go by in a dummy ioop in ITCM. (Do not aiiow any access to the ARM9 bus 
during this time.) 

2.4.3 New Block Reset 

When appiying a reset to the DSP biock, manipuiate the register shown beiow. 

System Configuration: New Biock Ciock Controi Register 

Name Address Attribute Initial Value 

SCFG RST 0x04004006 R/W 0x0000 


15 8 7 0 



DSP 

RSTB 




DSP Block Reset 

• DSPRSTB[d00] : DSP Biock Reset 


0 

Apply a reset to the DSP block 

1 

Undo the reset to the DSP block 
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2.4.4 Extended Features Control 

When switching between enabiing and disabiing the new biocks, or when using the circuits that correct 
probiems with NITRO, manipuiate the register shown beiow. 

System Configuration: Extended Features Controi Register 


Name 


Address 

Attribute Initial Value 

SCFG EXT 

0x04004008 


R/W 0X8307F100 


31 24 

23 18 17 16 

CFG 


WRAM 

DSP CAM DMAC 




New Block Access Control 




f Enable/Disable System Control Block ) 


15 14 

13 

12 


8 

7 


4 

3 

2 

1 

0 

PSRAM 

VRAM 

LCDC 


INTC 

MC 


DIV 

2DE 

REN 

GEO 

DMA 

NITRO Block Extended Features Control 

NITRO Block Circuit Revisions Control 


• CFG[d31] : System Controi Biock Enabie/Disabie 


0 

Access disabled 

1 

Access enabled 


Writing a 0 wiii prevent access to aii registers in the system controi biock (SCFG_* and MBK1-9: 
0x04004000-0x04004063) thereafter. Be sure to configure aii system configuration-reiated registers 
appropriateiy before writing a 0. 

• [d24-d16] : New Biock Access Controi 

Even if access is disabied to each biock, any vaiues that were set in the registers prior to that point wiii 
be vaiid. To be safe, be sure to change these bits oniy when no access to each biock is being 
generated. 

• WRAM[d24] : Access to New Shared WRAM 
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• [d15-d08] : NITRO Block Extended Feature Control 

For details on the extended features, refer to " 2.4.4.1 Extended Features " on page 14. 

• PSRAM[d15-d14] : Main Memory Limitations 


00 

01 

Limit to 4 MB boundary 

10 

Limit to 16 MB boundary 

11 

Limit to 32 MB boundary 


• VRAM[d13] : Extended VRAM Access 


0 

Same as NITRO 

1 

Extended VRAM access 


• LCDC[d12] : Extended LCDC Circuit 


0 

Same as NITRO 

1 

Extended LCDC circuit 


• INTC[d08] : Extended Interrupt Circuit 


0 

Same as NITRO 

1 

Extended interupt circuit 


• [d07-d00] : NITRO Block Circuit Revision Control 

For details on the revised features, refer to " 2.4.4.2 Revised Features " on page 14. 

• MC[d07] : TWL / NITRO Card Interface Circuit Revisions 


0 

Same as NITRO 

1 

Use the revised circuits 


• DIV[d04] : Divider Circuit Revisions 


0 

Same as NITRO 

1 

Use the revised circuits 


• 2DE[d03] : 2D Engine Circuit Revisions 


0 

Same as NITRO 

1 

Use the revised circuits 


• REN[d02] : Renderer Circuit Revisions 


0 

Same as NITRO 

1 

Use the revised circuits 


• GEO[d01] : Geometry Circuit Revisions 


0 

Same as NITRO 

1 

Use the revised circuits 
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• DMA[dOO] : NITRO-Compatible DMA Circuit Revisions 


0 

Same as NITRO 

1 

Use the revised circuits 


2.4.4.1 Extended Features 

Biocks that support bits wiii have extended features as shown beiow. To be safe, oniy change the bits 
when the various biocks are not operating. 

• Main Memory 

The size of the main memory can be iimited to 4 MB (for NITRO compatibiiity) or extended to 16 MB or 
32 MB boundaries. 


Figure 2-1 Differences Due to Main Memory Size 



4 MB (NITRO-compatible) 

16 MB 


32 MB 

OxOEOOOOOO 






OxODOOOOOO 

ALLO 


Main Memory Image (16 MB) 


Extended Main Memory (16 MB) 

OxOCOOOOOO 

ALLO 


Main Memory Image (16 MB) 


Main Memory Image (16 MB) 

0x03000000 







Main Memory Image (4 MB) 


Main Memory (16 MB) 


Main Memory (16 MB) 


Main Memory Image (4 MB) 






Main Memory Image (4 MB) 





0x02000000 

Main Memory (4 MB) 











• VRAM Access 

Wiii support a 32-bit bus width, and one-byte writes are possibie. 

• LCDC Circuit 

An LCD initiaiization signai wiii be added to the dispiay status register (DISPSTAT). 

• Interrupt Circuit 

Interrupt flags that support the new blocks will be added (New DMA 0-3, Camera, DSP). If this 
extended feature is turned off, the interrupt permission flags for the corresponding extended parts will 
all be initialized to 0 by the hardware. For details, refer to " 10 Interrupts " on page 311. 

2.4.4.2 Revised Features 

When using the circuits that revise the defects, you must set the corresponding bits to 1 and switch to 
using an SDK that supports the circuit revisions. It should be noted that changing the SDK could cause 
subtle changes in an application’s behavior, and routines that are coded with tight timing could be 
processed in a different order. To be safe, only change the bits when a given block is not operating. 

• TWL / NITRO Card Interface 

Bugs that used to occur when writing to multiple pages or writing 32-bit indefinite data have been fixed. 

• NITRO-Compatible DMA 

A bug in which high-priority DMA would run out of control if DMA was started on multiple channels in 
parallel on the ARM9 system bus has been fixed. Additionally, a bug in which it was impossible to 
specify an I/O register or the Game Pak bus as the source address for DMAO has been fixed. 
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• Geometry Circuit 

• BoxTest 

A bug in which the box used in the test wiii be judged to be out of view if aii six of its faces are 
outside the view voiume has been fixed. Additionaiiy, a bug that caused incorrect resuits to be 
returned when poiygon reduction occurred has been fixed. 

• TexImageParam Command 

A bug in which attributes set with TexlmageParamO/1 wiii be affected by the previous poiygon has 
been fixed. 

• Command FIFO 

A bug that causes unintended geometry commands to be inserted by a particuiar data array when 
packing commands or continuousiy writing to the geometry FIFO using the CPU has been fixed. 

• 1-Pixei Poiygons 

A bug that forces vertex sharing to be canceiied when 1 -pixei poiygons are removed from a group 
of iinked poiygons has been fixed. 

• Ciipping 

A bug in which the vaiues for the biue and green components of a vertex wiii turn to 0 (coior 
distortion) when a vertex is dipped has been fixed. 

• Renderer Circuit 

• 4x4 Compressed Textures 

A bug that caused 4x4 compressed textures with iinear interpoiation enabied to appear siightiy 
darker than the corresponding texture with no interpoiation (even for the exact same coior) has 
been fixed. 

• Shadow Poiygons 

A bug that caused shadow poiygons for masks and shadow poiygons for rendering to be rendered 
differentiy has been fixed. 

• 2D Graphics Engine 

A bug that caused the window to extend verticaiiy if the upper-ieft Y-coordinate was set to 6 or iess 
with the BG window feature and a bug that made it impossibie to specify a window that covers the 
entire dispiay area in the X direction have been fixed. 

• Divider Bug Revisions 

A bug that caused the Division by Zero Error fiag not to function properiy uniess aii 64 bits of the 
divisor (denominator) are zero has been fixed. 


2.4.5 New Shared WRAM 

Work RAM has been added, which can be shared by the ARM9, the subprocessor, and the DSP. Piease 
refer to " 3.2.2 Work RAM " on page 40 for more detaiis. 
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3 Memory 


Table 3-1 shows the configuration and specifications of the memory buiit into TWL. 

Table 3-1 : Memory Configuration and Specifications 


Memory Type 

Bus 

Width 

Access 

Cycle 

Bit Width that 
Allows DMA 
Access 

Bit Width that 
Allows Main 
Processor Access 

Bit Width that 
Allows New DMA 
Access 




Read 

Write 

Read 

Write 

Read 

Write 

0AM 

32 

1 

16/32 

16/32 

8/16/32 

16/32 

32 

32 

VRAM 

32*' /16 

1 

16/32 

16/32 

8/16/32 

8*'/ 

16/32 

32 

32 

Palette RAM 

16 

1 

16/32 

16/32 

8/16/32 

16/32 

32 

32 

I/O Registers 

32 

1 

16/32 

16/32 

8/16/32 

8/16/32 

32 

32 

Internal Work RAM 

32 

1 

16/32 

16/32 

8/16/32 

8/16/32 

32 

32 

Main Memory 

16 

1st R:5/W:4 
2nd 1 

16/32 

16/32 

8/16/32 

8/16/32 

32 

32 

System ROM 

32 

1 

- 

- 

8/16/32 

- 

- 

- 

TCM/Cache 

32 

1/2/1/4 *2 

- 

- 

8/16/32 

8/16/32 

- 

- 


The vaiues given for the number of access cycies correspond to a bus frequency of 33.514 MHz. 

These vaiues are for when memory is accessed in a bit width that is equai to or iess than the bus width. 
When memory is accessed in a bit width that is iarger than the bus width, the number of access cycies is 
iimited to the bit width divided by the bus width. 

Note 1 : In TWL mode, the system configuration can be used to set the VRAM bus width to 32 bits and to 
enabie 1-byte writes (configured using the SCFG_EXT register). 

Note 2: In TWL mode, the system configuration can be used to set the operating frequency of the main 
processor to 2x that of NITRO (134.06 MHz) (configured using the SCFG_CLK register). 

• Transfer speeds between memories 

DMA transfer speeds between memories can be caicuiated from the bus width and the access cycie 
vaiues shown in Tabie 3-1. Tabie 3-2 shows an exampie of DMA transfers between Internai Work RAM 
and VRAM. 


Table 3-2 : DMA Transfer Speeds between Internal Work RAM and VRAM (When the VRAM 

Bus Width Is 16 Bits) 


Transfer Memory 

DMA Transfer Bit 
Count 

Cycles Used 
for Reading 

Cycles Used 
for Writing 

Total Number 
of Cycles 

Transfer Speed 
(MB/sec) 

From Internal Work 

16 

1 

1 

2 

31.96 

RAM to VRAM 

32 

1 

2 

3 

42.62 

From VRAM to 

16 

1 

1 

2 

31.96 

Internal Work RAM 

32 

2 

1 

3 

42.62 
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Table 3-3 : DMA Transfer Speeds between Internal Work RAM and VRAM (When the VRAM 

Bus Width Is 32 Bits) 


Transfer Memory 

DMA Transfer Bit 
Count 

Cycles Used 
for Reading 

Cycles Used 
for Writing 

Total Number 
of Cycles 

Transfer Speed 
(MB/sec) 

From Internal Work 

16 

1 

1 

2 

31.96 

RAM to VRAM 

32 

1 

1 

2 

63.92 

From VRAM to 

16 

1 

1 

2 

31.96 

Internal Work RAM 

32 

1 

1 

2 

63.92 


• Main memory transfer speeds 

Main memory can function as a iook-ahead buffer by setting DMA for reading as shown in Tabie 3-4. 

Table 3-4 : DMA Settings to Function as a Look-Ahead Buffer 


Property to Set 

Set Value 

Transfer Bit Count 

32 bits 

How to Update Source Address 

Increment 

Destination Address 

Not main memory 


Capabie of hoiding 16 bits, the iook-ahead buffer reads from main memory whiie data is being written 
to the destination memory. 

Tabie 3-5 and Tabie 3-6 show the DMA transfer speeds between main memory and internai Work 
RAM, and between main memory and VRAM. The asterisk (*) denotes a shortening of the totai 
number of cycies due to the iook-ahead buffer. For more detaiis about the iook-ahead buffer, see 
" 3.1.1 Main Memory " on page 21. 


Table 3-5 : DMA Transfer Speeds Between Main Memory and Internal Work RAM 


Transfer Memory 

DMA 

Transfer Bit 
Count 

Cycles Used 
for Reading 

Cycles Used 
for Writing 

Total 

Number of 
Cycles 

Transfer Speed 
(MB/sec) 

From Main Memory to 

16 

1st 5 

2nd-1 

1 

1st 6 

2nd-2 

2nd-31.96 

Internal Work RAM 

32 

1st 6 

2nd-2 

1 

1st 7 
* 2nd- 2 

2nd- 63.92 


16 

1 

1st 4 

1st 5 

2nd-31.96 

From Internal Work RAM to 



2nd-1 

2nd- 2 


Main Memory 

32 

1 

1st 5 

2nd- 2 

1st 6 

2nd-3 

2nd- 42.62 
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Table 3-6 : DMA Transfer Speeds Between Main Memory and VRAM (When the VRAM Bus 

Width Is 16 Bits) 


Transfer Memory 

DMA 

Transfer Bit 
Count 

Cycles Used 
for Reading 

Cycles Used 
for Writing 

Total Number 
of Cycles 

Transfer Speed 
(MB/sec) 

From Main Memory to 

16 

1st 5 

2nd-1 

1 

1st 6 

2nd- 2 

2nd-31.96 

VRAM 

32 

1st 6 

2nd- 2 

2 

1st 8 
* 2nd- 3 

2nd- 42.62 

From VRAM to Main 

16 

1 

1st 4 

2nd-1 

1st 5 

2nd- 2 

2nd-31.96 

Memory 

32 

2 

1st 5 

2nd- 2 

1st 7 

2nd- 4 

2nd-31.96 


Table 3-7 : DMA Transfer Speeds Between Main Memory and VRAM (When the VRAM Bus 

Width Is 32 Bits) 


Transfer Memory 

DMA 

Transfer Bit 
Count 

Cycles Used 
for Reading 

Cycles Used 
for Writing 

Total Number 
of Cycles 

Transfer Speed 
(MB/sec) 

From Main Memory to 

16 

1st 5 

2nd-1 

1 

1st 6 

2nd- 2 

2nd-31.96 

VRAM 

32 

1st 6 

2nd- 2 

1 

1st 7 
* 2nd- 2 

2nd- 63.92 

From VRAM to Main 

16 

1 

1st 4 

2nd-1 

1st 5 

2nd- 2 

2nd-31.96 

Memory 

32 

1 

1st 5 

2nd- 2 

1st 6 

2nd- 3 

2nd- 42.62 


Transfer speeds by the CPU tend to be slower than calculated because the actual transfer speed is 
related to the time it takes to execute commands and get to the bus. 
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3.1 External Memory 

TWL/NITRO Game Card refers to the hardware for the TWL/NITRO Game Card slot. 


EXMEMCNT: External Memory Control Register 

Name: EXMEMCNT Address: 0x04000204 Attribute: R/W Initial Value: 0x0000 


15 


14 


11 


EP 

IFM 



MP 












Main Memory 

TWL/NITRO Game Card 










• [d15, d14]: Main Memory: Settings reiated to main memory 

• EP[d15]: Seiect the CPU priority 

This defines which CPU has priority when ARM9 and ARM7 access main memory at the same time. 



ARM9 priority 


ARM7 priority 


• IFM[d14]: Interface mode switch fiag 



Asynchronous mode 
(this setting prohibited) 


Synchronous mode 


Note: You must set this to Synchronous mode. 

• [d11 ]: Setting for the TWL/NITRO Game Card 

• MP[d11 ]: Select the CPU with access rights 


0 

ARM9 

1 

ARM7 
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3.1.1 Main Memory 

3.1.1.1 Look-Ahead Buffer 

A look-ahead buffer is implemented as the interface to main memory. This iook-ahead buffer is shared by 
ARM9 DMA and ARM7 DMA. 

When a 32-bit DMA transfer is conducted from a source address in main memory to a destination address 
other than main memory, the write time to the destination address is used to read the next data in 16-bit 
units. This method enabies 32-bit reads to be conducted in a singie read cycie. 

Note that the iook-ahead buffer cannot be used for other types of access, such as reading by the CPU or a 
16-bit DMA transfer. 

3.1.1.2 Burst Mode 

In Burst mode, the sequentiai access of a haif-word (16-bit width) is conducted in one cycie. 

Tabie 3-8 shows the basic access cycies for random access and sequentiai access in Burst mode. 


Table 3-8 : Basic Access Cycles 



Read 

Write 

Random 

5 cycles 

4 cycles 

Sequential 

1 cycle 

1 cycle 


3.1.1.2.1 Burst Access Conditions 

In Burst mode, sequential access is called burst access. 

Burst access is used during DMA transfer when either the source or the destination address is the main 
memory and the address update method for main memory is set to increment. 

Because DMA transfers from main memory to main memory are all first accesses, routing through internal 
RAM provides fast transfer speeds. 

In addition, burst access is also used when continuous transfers using LDM or STM instructions are 
executed. 

3.1.1.2.2 Conditions for Inserting Waits 

When a span of 236 half-words occurs, a wait of three cycles, called a termination, is inserted. 

When the address is defined from 0 in units of 16 half-words, waits are also inserted if access starts from 
address 13, 14, or 15, as shown in Table 3-9 (a maximum of 3 waits are inserted). Processes are thus 
more efficient if data are located from a 4 half-word boundary (8-byte boundary). 


Table 3-9 : Inserting Waits According to the Access Start Address 


First Cycle 

2 

3 

4 

5 

6 

7 

8 

9 

... 

13 

14 

15 

wait 

16 

17 

18 

19 

20 


14 

15 

wait 

wait 

16 

17 

18 

19 

20 


15 

wait 

wait 

wait 

16 

17 

18 

19 

20 
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3.1.1.2.3 Main Memory DMA Transfer Cycles 

3.1.1.2.3.1 32-Bit DMA Transfer Cycle from Main Memory to Work RAM 

Because main memory has a 16-bit bus and Work RAM has a 32-bit bus, data read in haif-word units is 
written in word units. Whiie writing in word units, the iook-ahead buffer reads more haif-word data. 
Transfers to the geometry command FIFO are the same as transfers to Work RAM. 

• Basic Cycies 

Figure 3-1 shows the basic cycies of the transfer sequence from main memory to Work RAM. 

Figure 3-1 : Transfer Sequence from Main Memory to Work RAM (Basic Cycles) 



237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 

248 

249 



117W 





118W 


■I19W 


120W 


117LR 

117HR 

T 

T 

T 

11 SLR 

118HR 

119LR 

119HR 

120LR 

120HR 

121LR 

121HR 


• Worst Case 

Depending on the main memory address where access starts, a wait known as a termination may 
occur. In these cases, the access immediately after the termination becomes the first access. 

Figure 3-2 shows the worst-case transfer sequence from main memory to Work RAM. 

Figure 3-2 : Transfer Sequence from Main Memory to Work RAM (Worst Case) 



14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 



2W 


3W 


4W 


5W 


6W 


7W 

2LR 

2HR 

SLR 

3HR 

4LR 

4HR 

SLR 

5HR 

6LR 

6HR 

7LR 

7HR 

8LR 



Wait 

Termination 

Reads the lower 16 bits of the nth 32-bit data 
Reads the upper 16 bits of the nth 32-bit data 
Writes the nth 32-bit data 
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3.1.1.2.3.2 Cycles for 32-bit DMA Transfers from Work RAM to Main Memory 


• Basic Cycles 

Figure 3-3 shows the basic cycles of the transfer sequence from Work RAM to main memory. 

Figure 3-3 : Transfer Sequence from Work RAM to Main Memory (Basic Cycles) 



2R 


wait wait wait 


1LW 1HW 


2LW 2HW 


10 

11 

12 

13 

3R 



4R 


3LW 

3HW 



352 

353 

354 

355 

356 

357 

358 

359 

360 

361 

117R 









118R 

wait 

T 

T 

T 

wait 

wait 

wait 

117LW 

117HW 



• Worst Case 

Depending on the main memory address where access starts, a wait known as a termination may 
occur. In these cases, the access immediately after the termination becomes the first access. 

Figure 3-4 shows the worst case transfer sequence from Work RAM to main memory. 

Figure 3-4 : Transfer Sequence from Work RAM to Main Memory (Worst Case) 



14 

15 

16 

17 

18 

19 

20 

21 



3R 



4R 



2LW 

2HW 


3LW 

3HW 


4LW 

4HW 



Wait 

Termination 

Reads the nth 32-bit data 

Writes the lower 16 bits of the nth 32-bit data 

Writes the upper 16 bits of the nth 32-bit data 
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3.1.1.2.3.3 Cycles for 32-bit DMA Transfers from Main Memory to VRAM (16-Bit Width) 

If the bus width for VRAM is set to 16 bits in the system configuration, data read in haif-word units is written 
in haif-word units because main memory and VRAM both have a 16-bit-width bus. Whiie writing in haif- 
word units, the iook-ahead buffer reads more data from main memory. 

• Basic Cycie 

Figure 3-5 shows the basic cycies of the transfer sequence from main memory to VRAM. 

Figure 3-5 : Transfer Sequence from Main Memory to VRAM (Basic Cycies, 16-Bit Width) 



352 

353 

354 

355 

356 

357 

358 

359 

360 

361 

362 



117LW 

117HW 








117LR 

117HR 

T 

T 

T 

wait 

wait 

wait 

wait 

11 SLR 

118HR 


• Worst Case 

Depending on the main memory address where access starts, a wait known as a termination may 
occur. In these cases, the access immediately after the termination becomes the first access. 

Figure 3-6 shows the worst-case transfer sequence from main memory to VRAM. 

Figure 3-6 : Transfer Sequence from Main Memory to VRAM (Worst Case, 16-Bit Width) 



14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 



2LW 

2HW 


3LW 

3HW 


4LW 

4HW 


5LW 

5HW 

2LR 

2HR 

SLR 


3HR 

4LR 


4HR 

SLR 


5HR 

6LR 




Wait 

Termination 

Reads the lower 16 bits of the nth 32-bit data 
Reads the upper 16 bits of the nth 32-bit data 
Writes the lower 16 bits of the nth 32-bit data 
Writes the upper 16 bits of the nth 32-bit data 
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3.1.1.2.3.4 Cycles for 32-bit DMA Transfers from VRAM (16-Bit Width) to Main Memory 

• Basic Cycles 


Figure 3-7 shows the basic cycles of the transfer sequence from VRAM to main memory. 

Figure 3-7 : Transfer Sequence from VRAM to Main Memory (Basic Cycies, 16-Bit Width) 



468 

469 

470 

471 472 473 

474 

475 

476 

477 

478 479 

480 

117LR 

117HR 


118LR 118HR 









117LW 

wait I 

T 

T 

wait 

wait 

nU|||fl 118LW 

118HW 


• Worst Case 

Depending on the main memory address where access starts, a wait known as a termination may 
occur. In these cases, the access immediately after the termination becomes the first access. 

Figure 3-8 shows the worst case 32-bit transfer sequence from VRAM to main memory. 

Figure 3-8 : 32-Bit Transfer Sequence from VRAM (16-Bit Width) to Main Memory (Worst 


Case) 



12 

13 

14 

15 

16 

17 

18 

19 

20 






SLR 

3HR 



wait 

wait 

wait 

2LW 

2HW 



3LW 

3HW 


wait 

Wait 

T 

Termination 

nLR 

Reads the lower 16 bits of the nth 32-bit data 

nHR 

Reads the upper 16 bits of the nth 32-bit data 

nLW 

Writes the lower 16 bits of the nth 32-bit data 

nHW 

Writes the upper 16 bits of the nth 32-bit data 
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3.1.1.2.3.5 32-Bit DMA Transfer Cycle from Main Memory to VRAM (32-Bit Width) 

If the bus width for VRAM is set to 32 bits in the system configuration, data read in haif-word units is written 
in word units because main memory has a 16-bit-width bus and VRAM has a 32-bit-width bus. Whiie 
writing in word units, the iook-ahead buffer reads next data from main memory. 

This transfer cycie is the same as a transfer sequence from main memory to Work RAM. 

• Basic Cycies 

Figure 3-9 shows the basic cycies of the transfer sequence from main memory to VRAM. 

Figure 3-9 : Transfer Sequence from Main Memory to VRAM (Basic Cycies, 32-Bit Width) 



237 

238 

239 

240 

241 

242 

243 

244 

245 

246 

247 



117W 









117LR 

117HR 

T 

T 

T 

wait 

wait 

wait 

wait 

11 SLR 

118HR 


• Worst Case 

Depending on the main memory address where access starts, a wait known as a termination may 
occur. In these cases, the access immediately after the termination becomes the first access. 

Figure 3-10 shows the worst-case transfer sequence from main memory to VRAM. 

Figure 3-10 : Transfer Sequence from Main Memory to VRAM (Worst Case, 32-Bit Width) 



14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 



2W 


3W 


4W 


5W 


6W 


7W 

2LR 

2HR 

SLR 

3HR 

4LR 

4HR 

SLR 

5HR 

6LR 

6HR 

7LR 

7HR 

SLR 



Wait 

Termination 

Reads the lower 16 bits of the nth 32-bit data 
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3.1.1.2.3.6 Cycles for 32-bit DMA Transfers from VRAM (32-Bit Width) to Main Memory 

Figure 3-11 shows the basic cycies of the transfer sequence from VRAM to main memory. 


Figure 3-11 : Transfer Sequence from VRAM to Main Memory (Basic Cycles, 32-Bit Width) 
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117LW 

117HW 
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T 

wait 

wait 

118LW 

118HW 


• Worst Case 

Depending on the main memory address where access starts, a wait known as a termination may 
occur. In these cases, the access immediately after the termination becomes the first access. 

Figure 3-12 shows the worst-case 32-bit transfer sequence from VRAM to main memory. 

Figure 3-12 : 32-Bit Transfer Sequence from VRAM (32-Bit Width) to Main Memory (Worst 


Case) 
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Reads the lower 16 bits of the nth 32-bit data 

nHR 

Reads the upper 16 bits of the nth 32-bit data 

nLW 

Writes the lower 16 bits of the nth 32-bit data 

nHW 

Writes the upper 16 bits of the nth 32-bit data 
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3.2 The TWL Processor's Internal Memory 

3.2.1 VRAM 

VRAM (A to I) does not have a fixed use, so it can be assigned for each appiication in the ways that make 
the most efficient use of memory resources. This abiiity is caiied VRAM bank control. Do not switch banks 
during access to VRAM. 

Tabie 3-10 shows the options for VRAM use. 


Table 3-10 : Options for VRAM Use 



VRAM 

A 

B 

c 

D 

E 

F 

G 

H 

1 

Use KB 

128 

128 

128 

128 

64 

16 

16 

32 

16 

LCDC 

X 

X 

X 

X 

X 

X 

X 

X 

X 

ARM7 



X 

X 







BG-VRAM 

X 

X 

X 

X 

X 

X 

X 




OBJ-VRAM 

X 

X 



X 

X 

X 



2D Graphics 
Engine A 

BG Extended 
Palette Slot 





X 

X 

X 




OBJ Extended 
Palette Slot 






X 

X 




BG-VRAM 



X 





X 

X 


OBJ-VRAM 




X 





X 

2D Graphics 
Engine B 

BG Extended 
Palette Slot 








X 



OBJ Extended 
Palette Slot 









X 

3D Graphics 

^RAnHprinn 

Texture Image 
Slot 

X 

X 

X 

X 






Engine) 

Texture Palette 
Slot 





X 

X 

X 




(BG is screen data or character data. OBJ is character data.) 


Memory assigned to LCDC, ARM7, BG-VRAM, and OBJ-VRAM is aiso mapped to the ARM9 bus, 
enabiing memory to be read and written by ARM9. Memory assigned to the extended paiette and texture 
siots is not mapped to the ARM9 bus. 

Note 1 : LCDC: The LCD controiier (LCDC) handies this region. VRAM A to D can be used as memory for 
hoiding bitmap data during VRAM dispiay mode and it can aiso be set as memory for writing bit¬ 
map data during captures. (For detaiis, see " 5.4.4.2 VRAM Dispiav Mode " on page 87 and " 5.5 
Dispiav Capture " on page 91.) 
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VRAM assigned to LCDC is uniqueiy mapped to the ARM9 bus. (When aii A-to-l of VRAM is 
assigned to LCDC, it is mapped in a contiguous region of the ARM9 bus.) Because there is no 
access from the CPU when VRAM is aiiocated to the Extended Paiette siot or the Texture Image/ 
Paiette siot, you need to temporariiy set data in LCDC to write data. 

Note 2: BG-VRAM: This region stores BG screen data, character data, and bitmap data. Up to 512 KB for 
2D Graphics Engine A or up to 128 KB for 2D Graphics Engine B can be assigned for this purpose. 

Note 3: OBJ-VRAM: This region stores OBJ character data and bitmap data. Up to 256 KB for 2D 

Graphics Engine A or up to 128 KB for 2D Graphics Engine B can be assigned for this purpose. 

Note 4: Extended paiette siots: This memory space is the property of the 2D graphics engine, which 

references coior data when BG and OBJ are dispiayed. The siots are not mapped in the CPU's 
memory space. 

Note 5: Texture image siot and texture paiette siot: This memory space is the property of the rendering 

engine inside the 3D graphics engine. The rendering engine references texei coiors when textures 
are biended. The siots are not mapped in CPU memory space. 
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VRAMCNT: RAM Bank Control Register 0 

Name: VRAMCNT Address: 0x04000240 Attribute: W Initial Value: 0x00000000 


31 


28 27 26 


24 


23 


20 19 18 16 


15 


12 11 98 



□ 

□ 

OFS 

MST 

0 

□ 

□ 

OFS 

MST 

0 

□ 

□ 

OFS 

□ 

MST 

0 

□ 

□ 

OFS 

□ 

MST 


4 3 10 


VRAM-D 


VRAM-C 


VRAM-B 


VRAM-A 


• VRAM-D, VRAM-C 

• E[d31][d23] Enable flag 


0 

Disable 

1 

Enable 


• OFS[d28-d27][d20-d19]: Allocated addresses (Allocated to the addresses shown below 

according to the MST: Allocation options) 

1. When MST = 000 

Aiiocated to LCDC and aiso mapped to ARM9 memory space 


VRAM-C 

0x06840000-0x0685FFFF 

VRAM-D 

0x06860000-0x0687FFFF 


2. When MST = 001 

Aiiocated to 2D Graphics Engine A's BG and aiso mapped to ARM9 memory space 



0x06000000-0x0601 FFFF 


0x06020000-0x0603FFFF 


0x06040000-0x0605FFFF 


0x06060000-0x0607FFFF 


3. When MST = 010 

Mapped to ARM7 memory space, so not mapped to ARM9 memory space 


00 

0x06000000-0x0601 FFFF 

01 

0x06020000-0x0603FFFF 

10 

Setting prohibited 

11 

Setting prohibited 
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4. When MST = Oil 

Allocated to texture image slot, but not mapped to ARM9 memory space 
(See the texture image siot memory map in Figure 3-13.) 


00 

Texture image slot 0 

01 

Texture image slot 1 

10 

Texture Image slot 2 (clear color Image) 

11 

Texture Image slot 3 (clear depth image) 


5. When MST= 100 

Mapped to the foiiowing ARM9 memory spaces, no matter what the setting 


VRAM-C 

0x06200000-0x0621 FFFF 

VRAM-D 

0x06600000-0x0661 FFFF 


• MST[d26-d24][d18-d16]: Aiiocation options 


000 

Allocate to LCDC 

001 

Allocate to 2D Graphic Engine A's BG 

010 

Allocate to ARM7 

oil 

Allocate to 3D rendering engine's texture image 

100 

For VRAM-C: Allocate to 2D Graphic Engine B's BG 

For VRAM-D: Allocate to 2D Graphic Engine B's OBJ 

101-111 

Setting prohibited 


Note: Aithough VRAM-C and VRAM-D can be aiiocated to the ARM7 subprocessor, to ensure that 
the subprocessor API operates correctiy, do not change the register settings. 

• VRAM-B, VRAM-A 

• E[d15][d07]: Enabiefiag 


0 

Disable 

1 

Enable 


• OFS[d12-d11][d04-d03]: Aiiocated addresses (Aiiocated to the addresses shown beiow 

according to the MST: Aiiocation options) 

1. When MST = 00 

Aiiocated to LCDS and aiso mapped to ARM9 memory space 



0x06800000-0x0681 FFFF 


0x06820000-0x0683FFFF 
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2. WhenMST = 01 

Allocated to the 2D Graphic Engine A's BG and aiso mapped to the ARM9 memory space 


00 

0x06000000-0x0601 FFFF 

01 

0x06020000-0x0603FFFF 

10 

0x06040000-0x0605FFFF 

11 

0x06060000-0x0607FFFF 


3. WhenMST=10 

Aiiocated to the 2D Graphic Engine A's OBJ and aiso mapped to the ARM9 memory space 


00 

0x06400000-0x0641 FFFF 

01 

0x06420000-0x0643FFFF 

10 

Setting prohibited 

11 

Setting prohibited 


4. WhenMST=11 

Aiiocated to the texture image siot, but not mapped to ARM9 memory space 
(See the texture image siot memory map in Figure 3-13.) 


00 

Texture image slot 0 

01 

Texture image slot 1 

10 

Texture Image slot 2 (clear color Image) 

11 

Texture Image slot 3 (clear depth image) 


• MST[d09-d08][d01-d00]: Aiiocation options 


00 

Allocated to the LCDC 

01 

Allocated to the 2D Graphic Engine A's BG 

10 

Allocated to the 2D Graphic Engine A's OBJ 

11 

Allocated to the 3D rendering engine's texture Image 


Operation is not guaranteed when muitipie VRAM biocks are mapped to the same address or 
assigned to the same siot. 
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Texture image slots are memory-mapped in the rendering engine as in Figure 3-13. 

Figure 3-13 : Texture Image Slot Memory Map 


0x00080000 



Slots 

0x00060000 

(clear depth image) 


Slot 2 

0x00040000 

(clear color image) 

0x00020000 

Slot 1 

0x00000000 

SlotO 


Texture image Slot 2 and Slot 3 also works as a clear image buffer to initialize the rendering buffer. 
(Read about initializing with a clear image in " 7.3.3 Initializing the Rendering Buffers " on page 256). 

WVRAMCNT: RAM Bank Control Register 1 

Name: WVRAMCNT Address: 0x04000244 Attribute: W Initial value: 0x00000000 



• VRAM-G, VRAM-F 

• E[d23][d15]: Enable flag 


0 

Disable 

1 

Enable 


• OFS[d20-d19][d12-d11 ]: Allocated addresses (Allocated to the addresses shown below according to 
the MST: Allocation options) 

1. When MST = 000 

Allocated to LCDC and also mapped to ARM9 memory space 


VRAM-F 

0x06890000-0x06893FFF 

VRAM-G 

0x06894000-0x06897FFF 


2. When MST = 001 

Allocated to the 2D Graphic Engine A's BG and also mapped to ARM9 memory space 


00 

0x06000000-0x06003FFF 

01 

0x06004000-0x06007FFF 

10 

0x06010000-0x06013FFF 

11 

0x06014000-0x06017FFF 
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3. When MST = 010 

Allocated to the 2D Graphic Engine A's OBJ and aiso mapped to ARM9 memory space 


00 

0x06400000-0x06403FFF 

01 

0x06404000-0x06407FFF 

10 

0x06410000-0x06413FFF 

11 

0x06414000-0x06417FFF 


4. When MST = 011 

Aiiocated to the texture paiette siot, but not mapped to ARM9 memory space. 
(See the texture paiette siot memory map in Figure 3-14.) 


00 

Texture palette slot 0 

01 

Texture palette slot 1 

10 

Texture palette slot 4 

11 

Texture palette slot 5 


5. When MST =100 

Aiiocated to the 2D Graphic Engine A's BG extended paiette siot, but not mapped to ARM9 
memory space. 

(See the BG extended paiette siot memory map in Figure 3-15.) 


00 

2D Graphic Engine A BG extended palette slets 0-1 

01 

2D Graphic Engine A BG extended palette slets 2-3 

10 

Setting prohibited 

11 

Setting prohibited 


6. When MST =101 

Aiiocated to the 2D Graphic Engine A's OBJ extended paiette siot, but not mapped to ARM9 
memory space. 

The iower 8 KB are aiiocated to the siot, but the upper 8 KB are invaiidated. 

(See the OBJ extended paiette siot memory map in Figure 3-16.) 
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• MST[d18-d16][d10-d08]: Allocation options 


000 

Allocated to the LCDC 

001 

Allocated to the 2D Graphic Engine A's BG 

010 

Allocated to the 2D Graphic Engine A's OBJ 

oil 

Allocated to the 3D Rendering Engine’s texture palette 

100 

Allocated to the 2D Graphic Engine A's BG extended palette 

101 

Allocated to the 2D Graphic Engine A's OBJ extended palette 


Setting prohibited 


• VRAM-E 

• E[d07]: Enabie fiag 


0 

Disable 

1 

Enable 


• MST[d02-d00]: Aiiocation options 


000 

Allocated to the LCDC 

001 

Allocated to the 2D Graphic Engine A's BG 

010 

Allocated to the 2D Graphic Engine A's OBJ 

oil 

Allocated to the 3D Rendering Engine’s texture palette 

100 

Allocated to the 2D Graphic Engine A's BG extended palette 


Setting prohibited 


Note: VRAM-E mapping is fixed according to the MST settings shown beiow. (The offset cannot be 
changed.) 


000 

ARM9 addresses 0x06880000-0x0688FFFF 

001 

ARM9 addresses 0x06000000-0x0600FFFF 

010 

ARM9 addresses 0x06400000-0x0640FFFF 

oil 

Texture palette slots 0-3 

100 

BG extended palette slots 0-3 (only the lower 32 KB) 


The texture paiette siots are mapped in the Rendering Engine (see Figure 3-14) when VRAM biocks E, F, 
and G are assigned. The BG paiette siots are mapped as shown in Figure 3-15. 
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Figure 3-14 : Texture Palette Slot Memory Map 

0x00018000 


0x00014000 

Slots 

0x00010000 

Slot 4 

OxOOOOCOOO 

Slots 

0x00008000 

Slot 2 

0x00004000 

Slot 1 

0x00000000 

SlotO 


Figure 3-15 : BG Extended Palette Slot Memory Map 

0x00008000 


0x00006000 

Slots 

0x00004000 

Slots 

0x00002000 

Slot 1 

0x00000000 

SlotO 


Figure 3-16 shows the memory map when VRAM-F and -G are allocated to the OBJ extended palette. 

Figure 3-16 : OBJ Extended Palette Slot Memory Map 


0x00004000 


0x00002000 

Slot 1 

0x00000000 

SlotO 


Proper operation is not guaranteed when multiple VRAM blocks are mapped to the same address or 
assigned to the same slot. 


VRAM_HI_CNT: RAM Bank Control Register 2 

Name: VRAM HI CNT Address: 0x04000248 Attribute: W Initial value: 0x0000 


15 


10 


8 


0 


E 






MST 

E 






MST 

VRAM-1 

VRAM-H 


• VRAM-1, VRAM-H 

• E[d15][d07]: Enable flag 



Disable 


Enable 
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• MST[d09-d08][d01-d00]: Allocation options 

• For VRAM-H 


00 

Allocated to LCDC 

Mapped to main processor addresses 0x06898000-0x0689FFFF 

01 

Allocated to 2D Graphics Engine B's BG 

Mapped to main processor addresses 0x06200000-0x06207FFF 

10 

Allocated to 2D Graphics Engine B's BG extended palette 

Mapped to slots 0-3 

11 

Setting prohibited 


• For VRAM-1 


00 

Allocated to LCDC 

Mapped to main processor addresses 0x068A0000-0x068A3FFFF 

01 

Allocated to 2D Graphics Engine B's BG 

Mapped to main processor addresses 0x06208000-0x0620BFFF 

10 

Allocated to 2D Graphics Engine B's OBJ 

Mapped to main processor addresses 0x06600000-0x06603FFF 

11 

Allocated to 2D Graphics Engine B's OBJ extended palette 

Mapped to slots 0-1 


Tabie 3-11 through Tabie 3-16 show the addresses aiiocated to the various VRAM biocks for the given 
MST and OFS bits. 


Table 3-11 : VRAM-A and VRAM-B Allocations 


MST 

OFS 

Allocation 

00 

01 

10 

11 

00 

ARMg 

VRAM-A: 0x06800000-0x0681 FFFF 

VRAM-B: 0x06820000-0x0683FFFF 

01 

2D Graphics 

Engine A 

BG-VRAM 
(0x06000000- 
0x0601 FFFF) 

BG-VRAM 

(0x06020000- 

0X0603FFFF) 

BG-VRAM 

(0x06040000- 

0X0605FFFF) 

BG-VRAM 

(0x06060000- 

0X0607FFFF) 

10 

2D Graphics 

Engine A 

OBJ-VRAM 
(0x06400000- 
0x0641 FFFF) 

OBJ 

-VRAM 

(0x06420000- 

0X0643FFFF) 

Setting prohibited 

11 

Texture Image 

SlotO 

Slot 1 

Slot 2 

Slot 3 




(clear 

mage) 


© 2008-2009 Nintendo 
CONFIDENTIAL 


37 


TWL-06-0017-001-D 
Released: February 16, 2009 

































TWL Programming Manual 


Table 3-12 : VRAM-C and VRAM-D Allocations 


MST 

OFS 

Allocation 

00 

01 

10 

11 

000 

ARMg 

VRAM-C: 0x06840000-0x0685FFFF 

VRAM-D: 0x06860000-0x0687FFFF 

001 

2D Graphics 
Engine A 

BG-VRAM 
(0x06000000- 
0x0601 FFFF) 

BG-VRAM 

(0x06020000- 

0X0603FFFF) 

BG-VRAM 

(0x06040000- 

0X0605FFFF) 

BG-VRAM 

(0x06060000- 

0X0607FFFF) 

010 

ARM7 

ARM7 

0x06000000- 
0x0601 FFFF 

ARM7 

0x06020000- 

0X0603FFFF 

Setting prohibited 

oil 

Texture Image 

SlotO 

Slot 1 

Slot 2 

Slot 3 




(clear 

mage) 

100 

2D Graphics 
Engine B 

VRAM-C: BG-VRAM (0x06200000-0x0621 FFFF) 

VRAM-D: OBJ-VRAM (0x06600000-0x0661 FFFF) 

101- 

111 

Setting 

Prohibited 

Setting prohibited 


Table 3-13 : VRAM-E Allocations 


MST 

Allocation 

Address 

000 

ARMg 

0x06880000-0x0688FFFF 

001 

2D Graphics Engine A 

BG-VRAM (0x06000000-0x0600FFFF) 

010 

2D Graphics Engine A 

OBJ-VRAM (0x06400000-0x0640FFFF) 

oil 

Texture Palette 

Texture palette slot 0-3 

100 

2D Graphics Engine A 

BG extended palette slots 0-3 (only the lower 32 KB are valid) 

101- 

111 

Setting Prohibited 

Setting prohibited 
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Table 3-14 : VRAM-F and VRAM-G Allocations 


MST 

OFS 

Allocation 

00 

01 

10 

11 

000 

ARMg 

VRAM-F: 0x06890000-0x06893FFF 

VRAM-G: 0x06894000-0x06897FFF 

001 

2D Graphics Engine A 

BG-VRAM 

(0x06000000- 

0X06003FFF) 

BG-VRAM 

(0x06004000- 

0X06007FFF) 

BG-VRAM 
(0x06010000- 
0x06013FFF) 

BG-VRAM 
(0x06014000- 
0x06017FFF) 

010 

2D Graphics Engine A 

OBJ-VRAM 

(0x06400000- 

0X06403FFF) 

OBJ-VRAM 

(0x06404000- 

0X06407FFF) 

OBJ-VRAM 
(0x06410000- 
0x06413FFF) 

OBJ-VRAM 
(0x06414000- 
0x06417FFF) 

oil 

Texture Palette 

SlotO 

Slot 1 

Slot 4 

Slots 

100 

2D Graphics Engine A 

BG extended 
palette slots 0-1 

BG extended 
palette slots 2-3 

Setting prohibited 

101 

2D Graphics Engine A 

OBJ extended palette slot 0 (only lower 8 KB are valid) 

110 

Setting Prohibited 




111 

Setting Prohibited 






Table 3-15 : VRAM-H Allocations 


MST 

Allocation 

Address 

00 

ARMg 

0x06898000-0x0689FFFF 

01 

2D Graphics Engine B 

BG-VRAM (0x06200000-0x06207FFF) 

10 

2D Graphics Engine B 

BG extended palette slots 0-3 

11 

Setting Prohibited 

Setting prohibited 


Table 3-16 : VRAM-1 Allocations 


MST 

Allocation 

Address 

00 

ARMg 

0x068A0000-0x068A3FFFF 

01 

2D Graphics Engine B 

BG-VRAM (0x06208000-0x0620BFFF) 

10 

2D Graphics Engine B 

OBJ-VRAM (0x06600000-0x06603FFF) 

11 

2D Graphics Engine B 

OBJ extended palette slots 0-1 
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3.2.2 Work RAM 

In addition to the WRAM-0/1 (32 KB) shared by NITRO, the TWL aiso has the foiiowing areas of Work 
RAM avaiiabie: 

• WRAM-A[0-3] (256 KB), which can be shared between the ARM9 and ARM7 

• WRAM-B[0-7] (256 KB), which can be shared between the ARM9, ARM7, and DSP 

• WRAM-C[0-7] (256 KB), which can be shared between the ARM9, ARM7, and DSP 

WRAM-0/1 settings are configured in the same way they were on NITRO, by setting RAM Bank Controi 
Register 1 (WVRAMCNT). 

WRAM-A, B, and C settings are configured using WRAM Bank Controi Registers 1 -8 (MBK1-MBK8) in the 
system configuration register. If the enabled regions overlap with each other, the WRAM will be mapped 
with the priorities WRAM-A > WRAM-B > WRAM-C. An instance and image of WRAM-01 (or ARM7-dedi- 
cated WRAM for ARM7 addresses located at or after 0x38000000) will be mapped to disabled regions. 

3.2.2.1 WRAM-0/1 

Work RAM does not have a fixed use, so it can be assigned for each application in ways that make the 
most efficient use of memory resources. This ability is called WRAM bank control. 

Be sure not to switch banks while Work RAM is being accessed. 

WVRAMCNT: RAM Bank Control Register 1 

Name: WVRAMCNT Address: 0x04000244 Attribute: W Initial value: 0x00000000 


31 


25 24 


23 


20 19 18 16 


15 


12 11 10 


□ 

□ 

□ 

□ 

□ 

□ 

BANK 


□ 

□ 

OFS 

MST 

0 

□ 

□ 

OFS 

MST 


□ 

□ 

□ 

□ 

MST 


WRAM 


VRAM-G 


VRAM-F 


VRAM-E 


• WRAM 

• BANK[d25-d24]: Bank Specification 

Selects whether to allocate 16 KB x 2 blocks to ARM9 or ARM7. 
Figure 3-17 shows the memory maps for each value setting. 


ARM9 

ARM7 

00 

32KB 

None 

01 

16KB (Blocki) 

16KB (BlockO) 

10 

16KB (BlockO) 

16KB (Blocki) 

11 

None 

32KB 


Note: Though you can change the Work RAM settings, to ensure that the subprocessor API operates 
correctly, do not change the register settings. 
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Figure 3-17 : Memory Maps for Various Settings of ARM9, ARM7 Shared internai Work RAM 


ARM9 Memory Mao 

Allocation for Entire Region (32KB) 


0x04000000 

I/O registers 


Image of ARM9, ARM7 shared 

Internal Work RAM 

0x03800000 


0X037F8000 

ARM9, ARM7 shared Internal 

Work RAM (32KB) 

0x03000000 

Image of ARM9, ARM7 shared 

Internal Work RAM 

0x02000000 

Main memory Image 


Block 1 Allocation (16KB) 


0x04000000 

I/O registers 

0x03800000 

Image of ARM9, ARM7 shared 

Internal Work RAM (block 1) 

0X037FC000 

ARM9, ARM7 shared internal Work 
RAM (block 1: 16KB) 

0x03000000 

Image of ARM9, ARM7 shared internal 
Work RAM (block 1) 

0x02000000 

Main memory Image 


Block 0 Allocation (16KB) 


0x04000000 

I/O registers 

0x03800000 

Image of ARM9, ARM7 shared Internal 
Work RAM (block 0) 

0X037FC000 

ARM9, ARM7 shared internal Work 
RAM (block 0: 16KB) 

0x03000000 

Image of ARM9, ARM7 shared 
internal Work RAM (block 0) 

0x02000000 

Main memory Image 


No Allocation 


0x04000000 

I/O registers 


Undefined data 

0x03000000 


0x02000000 

Main memory image 


ARM7 Memory Mao 
No Allocation 


0x04000000 

I/O registers 

0x03810000 

Image of ARM7 dedicated 
internal Work RAM 

0x03800000 

ARM7 dedicated Internal 

Work RAM {64KB) 


Image of ARM7 dedicated 
internal Work RAM (32KB) 

0x03000000 


0x02000000 

Main memory Image 


Block 0 Allocation (16KB) 


0x04000000 

I/O registers 

0x03810000 

Image of ARM7 dedicated 

Internal Work RAM 

0x03800000 

ARM7 dedicated Internal 

Work RAM {64KB) 

0X037FC000 

Image of ARM9, ARM7 shared internal 
Work RAM (block 0: 16KB) 

0x03000000 

Image of ARM9, ARM7 shared internal 
Work RAM (block 0) 

0x02000000 

Main memory Image 


Block 1 Allocation (16KB) 


0x04000000 

I/O registers 

0x03810000 

Image of ARM7 dedicated 
internal Work RAM 

0x03800000 

ARM7 dedicated Internal 

Work RAM (64KB) 

0X037FC000 

Image of ARM9, ARM7 shared Internal 
Work RAM (block 1:16KB) 

0x03000000 

Image of ARM 9, ARM7 shared 
internal Work RAM (block 1) 

0x02000000 

Main memory Image 


Allocation for Entire Region (32KB) 


0x04000000 

I/O registers 

0x03810000 

Image of ARM7 dedicated 
internal Work RAM 

0x03800000 

ARM7 dedicated Internal 

Work RAM {64KB) 

0X037F8000 

ARM9, ARM7 shared Internal 

Work RAM (32KB) 

0x03000000 

Image of ARM9, ARM7 shared 
internal Work RAM 

0x02000000 

Main memory Image 
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3.2.2.2 WRAM-A 

WRAM-A can be mapped to memory by assigning four 64KB memory biocks to the ARM9 or ARM7 siots 
(offsets). WRAM Bank Controi Register 1 (MBK1) is used to set which memory is assigned to which siot. 


MBK1: WRAM Bank Control Register 1 

Name: MBK1 Address: 0x04004040 Attribute: R/W Initial value: 0x00000000 


31 


27 26 24 


23 


19 18 16 


15 


1110 8 



□ 

□ 

□ 

OF 

□ 


B 

□ 

□ 

□ 

OF 

□ 


B 

□ 

□ 

□ 

OF 

□ 


B 

□ 

□ 

□ 

OF 

□ 



3 2 


WRAM-A3 


WRAM-A2 


WRAM-A1 


WRAM-AO 


• WRAM-A[0-3] 

• E[d31][d23][d15][d07]: Enable Setting 

Seiects whether to enabie (1) or disabie (0) each of the WRAM-A memory biocks. 

• OF[d27-d26][d19-d18][d11-d10][d03-d02]: Offset Setting 

Specifies the assignment iocation (offset 0-3) for each of the WRAM-A memory biocks. 


Effect of Settings 

00 

Assign WRAM-Ax to the offset 0 memory region (slot 0) 

01 

Assign WRAM-Ax to the offset 1 memory region (slot 1) 

10 

Assign WRAM-Ax to the offset 2 memory region (slot 2) 

11 

Assign WRAM-Ax to the offset 3 memory region (slot 3) 


• M[d24][d16][d08][d00]: Master Setting 

Specifies the master for each of the WRAM-A memory biocks. 



Effect of Settings 

00 

Set ARM9 as the master for WRAM-Ax 

01 

Set ARM7 as the master for WRAM-Ax 


Be sure to set different combinations of masters and offsets for each WRAM-A memory biock. 

For exampie: 

WRAM-AO Siot 0 on ARM9 (M=0, OF=00) 

WRAM-A1 Siot 1 on ARM9 (M=0, OF=01) 

WRAM-A2 Siot 0 on ARM7 (M=1, OF=00) 

WRAM-A3 Siot 1 on ARM7 (M=1, OF=01) 

Next, set the region image size and the starting and ending addresses using WRAM Controi Register 6 
(MBK6) of the ARM9 and ARM7. 
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MBK6: WRAM Bank Control Register 6 

Name: MBK6 Address: 0x04004054 Attribute: R/W Initial value: 0x00000000 


31 28 20 13 12 11 4 0 


□ 

n 

n 

EADDR 

n 

n 

n 

n 

n 

n 

IS 

SADDR 

n 

n 

n 

□ 

WRAM-A 


• WRAM-A 

• EADDR[d28-d20]: End Address Setting 

Specifies the end address of the WRAM-A region. The address is specified in 64KB chunks. 
End Address = 0x02FFFFFF -h (EADDR « 16) (0x02FFFFFF-0x03FFFFFF) 


• IS[d13-d12]: Image Size Setting 

Specifies the image size of the WRAM-A region. 


Effect of Settings 


Repeat the WRAM-A slot 0 Image In 64KB units 



Repeat the WRAM-A slot 0-2 Images In 128KB units 


Repeat the WRAM-A slot 0-3 Images In 258KB units 


• Setting the image size to 64KB units (IS=00, 01) 



0x04000000 

END 

Disabled region 

OxOSFFOOOO 

SlotO 



0x03030000 



Enabled region 

0x03020000 

SlotO 

START 


0x03010000 

SlotO 


Disabled region 

0x03000000 

SlotO 

Setting th 

e image size to 128KB units (IS=10) 

0x04000000 

END 

Disabled region 

0X03FF0000 

Slot 1 



0x03030000 



Enabled region 

0x03020000 

SlotO 

START 


0x03010000 

Slot 1 
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Disabled region 

0x03000000 

SlotO 

Setting th 

e image size to 256KB units (IS=11) 

0x04000000 

END 

Disabled region 

OxOSFFOOOO 

Slot 3 



0x03030000 



Enabled region 

0x03020000 

Slot 2 

START 


0x03010000 

Slot 1 


Disabled region 

0x03000000 

SlotO 


• SADDR[d11-d04]: Start Address Setting 

Specifies the start address of the WRAM-A region. The address is specified in 64KB chunks. 
Start Address = 0x03000000 + (SADDR « 16) (0x03000000-0x03FF0000) 


If enabied regions overiap, they wiii be mapped with the priority WRAM-A > WRAM-B > WRAM-C, and 
WRAM-0/1 wiii be mapped to any disabied regions if no other shared RAM has been mapped. Regarding 
access to siots to which no memory biocks have been assigned, writes are disabied, and reads wiii aiways 
return a 0. 

For exampie: 

If the ARM9 image size is set to 256KB units (IS=11), and the memory biocks are assigned to each siot 
as shown beiow, the siot 1 region of the ARM9 wiii have writes disabied, and reads wiii return aii Os. 

WRAM-AO Siot 0 on ARM9 (M=0, OF=00) 

WRAM-A1 Siot 0 on ARM7 (M=1, OF=00) 

WRAM-A2 Siot 2 on ARM9 (M=0, OF=10) 

WRAM-A3 Siot 3 on ARM9 (M=0, OF=11) 

3.2.2.3 WRAM-B 

WRAM-B can be mapped to memory by assigning eight 32KB memory biocks to the siots (offsets) on the 
ARM9, ARM7, or DSP program bus. WRAM Bank Controi Registers 2 and 3 (MBK2, MBK3) are used to 
set which memory is assigned to which siot. 
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MBK2: WRAM Bank Control Register 2 

Name: MBK2 Address: 0x04004044 Attribute: R/W Initial value: 0x00000000 



• WRAM-B[0-3] 

• E[d31][d23][d15][d07]: Enable Setting 

Selects whether to enable (1) or disable (0) each of the WRAM-B memory blocks. 

• OF[d28-d26][d20-d18][d12-d10][d04-d02]: Offset Setting 

Specifies the assignment iocation (offset 0-7) for each of the WRAM-B memory biocks. 


Effect of Settings 


Assign WRAM-Bx to the offset 0 memory region (slot 0) 


Assign WRAM-Bx to the offset 1 memory region (slot 1) 


Assign WRAM-Bx to the offset 2 memory region (slot 2) 


Assign WRAM-Bx to the offset 3 memory region (slot 3) 


Assign WRAM-Bx to the offset 4 memory region (slot 4) 


Assign WRAM-Bx to the offset 5 memory region (slot 5) 


Assign WRAM-Bx to the offset 6 memory region (slot 6) 


Assign WRAM-Bx to the offset 7 memory region (slot 7) 


• M[d25-d24][d17-d16][d09-d08][d01-d00]: Master Setting 

Specifies the master for each of the WRAM-B memory biocks. 




Set ARM9 as the master for WRAM-Bx 


Set ARM7 as the master for WRAM-Bx 


Set the DSP (program bus) as the master for WRAM-Bx 
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Name: MBK3 


MBK3: WRAM Bank Control Register 3 

Address: 0x04004048 Attribute: R/W Initial value: 0x00000000 


31 28 26 25 24 

23 20 18 17 16 

15 12 10 9 8 

7 4 2 1 0 

0 



OF 


B 

□ 


OF 


B 


□ 

OF 


B 

□ 


OF 


WRAM-B7 

WRAM-B6 

WRAM-B5 

WRAM-B4 


• WRAM-B[4-7] 

• E[d31][d23][d15][d07]: Enable Setting 

Selects whether to enable (1) or disable (0) each of the WRAM-B memory blocks. 

• OF[d28-d26][d20-d18][d12-d10][d04-d02]: Offset Setting 

Specifies the assignment iocation (offset 0-7) for each of the WRAM-B memory biocks. 




Assign WRAM-Bx to the offset 0 memory region (slot 0) 


Assign WRAM-Bx to the offset 1 memory region (slot 1) 


Assign WRAM-Bx to the offset 2 memory region (slot 2) 


Assign WRAM-Bx to the offset 3 memory region (slot 3) 


Assign WRAM-Bx to the offset 4 memory region (slot 4) 


Assign WRAM-Bx to the offset 5 memory region (slot 5) 


Assign WRAM-Bx to the offset 6 memory region (slot 6) 


Assign WRAM-Bx to the offset 7 memory region (slot 7) 


• M[d25-d24][d17-d16][d09-d08][d01-d00]: Master Setting 

Specifies the master for each of the WRAM-B memory biocks. 


Effect of Settings 

00 

Set ARM9 as the master for WRAM-Bx 

01 

Set ARM7 as the master for WRAM-Bx 

10 

Set the DSP (program bus) as the master for WRAM-Bx 

11 


Be sure to set different combinations of masters and offsets for each WRAM-B memory biock. 
For exampie: 

WRAM-BO Siot 0 on ARM9 (M=00, OF=000) 

WRAM-B1 Siot 1 on ARM9 (M=00, OF=001) 

WRAM-B2 Siot 2 on ARM9 (M=00, OF=010) 

WRAM-B3 Siot 3 on ARM9 (M=00, OF=011) 
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WRAM-B4 Slot 0 on ARM7 (M=01, OF=000) 

WRAM-B5 Slot 1 on ARM7 (M=01, OF=001) 

WRAM-B6 Slot 0 on DSP (program bus) (M=10, OF=000) 

WRAM-B7 Slot 1 on DSP (program bus) (M=10, OF=001) 


Next, set the region image size and the starting and ending addresses using WRAM Controi Register 7 
(MBK7) of the ARM9 and ARM7. 

MBK7: WRAM Bank Control Register 7 

Name: MBK7 Address: 0x04004058 Attribute: R/W Initial value: 0x00000000 


31 28 19 13 12 11 30 


□ 

□ 

□ 

EADDR 

□ 

□ 

□ 

□ 

□ 

IS 

SADDR 

□ 

□ 

□ 


WRAM-B 


• WRAM-B 

• EADDR[d28-d19]: End Address Setting 

Specifies the end address of the WRAM-B region. The address is specified in 32KB chunks. 
End Address = 0x02FFFFFF -h (EADDR « 15) (0x02FFFFFF-0x03FFFFFF) 

• IS[d13-d12]: Image Size Setting 

Specifies the image size of the WRAM-B region. 


Effect of Settings 

00 

Repeat the WRAM-B slot 0 Image In 32KB units 

01 

Repeat the WRAM-B slot 0-1 Images In 64KB units 

10 

Repeat the WRAM-B slot 0-3 Images In 128KB units 

11 

Repeat the WRAM-B slot 0-7 Images In 258KB units 


• Setting the image size to 32KB units (IS=00) 

0x04000000 


END 

Disabled region 

0X03FF8000 

SlotO 

0X03FF0000 

SlotO 

START 

Enabled region 

0x03030000 


0x03028000 

SlotO 

0x03020000 

SlotO 

0x03018000 

SlotO 

0x03010000 

SlotO 


Disabled region 

0x03008000 

SlotO 

0x03000000 

SlotO 
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• Setting the image size to 64KB units (IS=01) 

0x04000000 


END 

Disabled region 

0X03FF8000 

Slot 1 

OxOSFFOOOO 

SlotO 

START 

Enabled region 

0x03030000 


0x03028000 

Slot 1 

0x03020000 

SlotO 

0x03018000 

Slot 1 

0x03010000 

SlotO 


Disabled region 

0x03008000 

Slot 1 

0x03000000 

SlotO 


• Setting the image size to 128KB units (IS=10) 

0x04000000 


END 

Disabled region 

0X03FF8000 

Slot 3 

0X03FF0000 

Slet2 

START 

Enabled region 

0x03030000 


0x03028000 

Slet 1 

0x03020000 

SletO 

0x03018000 

Slet 3 

0x03010000 

Slot 2 


Disabled region 

0x03008000 

Slot 1 

0x03000000 

SlotO 


• Setting the image size to 256KB units (IS=11) 

0x04000000 


END 

Disabled reglen 

0X03FF8000 

Slot? 

0X03FF0000 

Slots 

START 

Enabled region 

0x03030000 


0x03028000 

Slots 

0x03020000 

Slot 4 

0x03018000 

Slot 3 

0x03010000 

Slot 2 


Disabled reglen 

0x03008000 

Slot 1 

0x03000000 

SlotO 


TWL-06-0017-001-D 
Released: February 16, 2009 


48 


© 2008-2009 Nintendo 
CONFIDENTIAL 



TWL Programming Manual 


• SADDR[d11-d03]: Start Address Setting 

Specifies the start address of the WRAM-B region. The address is specified in 32KB chunks. 
Start Address = 0x03000000 + (SADDR « 15) (0x03000000-0x03FF8000) 


If enabied regions overiap, they wiii be mapped with the priority WRAM-A > WRAM-B > WRAM-C, and 
WRAM-0/1 wiii be mapped to any disabied regions if no other shared RAM has been mapped. Regarding 
access to siots to which no memory biocks have been assigned, writes are disabied, and reads wiii aiways 
return a 0. 


3.2.2.4 WRAM-C 

WRAM-C can be mapped to memory by assigning eight 32KB memory biocks to the siots (offsets) on the 
ARM9, ARM7, or DSP data bus. WRAM Bank Controi Registers 4 and 5 (MBK4, MBK5) are used to set 
which memory is assigned to which siot. 

MBK4: WRAM Bank Control Register 4 

Name: MBK4 Address: 0x0400404C Attribute: R/W Initial value: 0x00000000 


31 28 26 25 24 

23 20 18 17 16 

15 12 10 9 8 

7 4 2 1 0 

0 

□ 

□ 

OF 


B 

□ 

□ 

OF 


B 

□ 

□ 

OF 


B 

□ 

□ 

OF 


WRAM-C3 

WRAM-C2 

WRAM-C1 

WRAM-CO 


• WRAM-C[0-3] 

• E[d31][d23][d15][d07]: Enable Setting 

Seiects whether to enabie (1) or disabie (0) each of the WRAM-C memory biocks. 

• OF[d28-d26][d20-d18][d12-d10][d04-d02]: Offset Setting 

Specifies the assignment iocation (offset 0-7) for each of the WRAM-C memory biocks. 
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Effect of Settings 

000 

Assign WRAM-Cx to the offset 0 memory region (slot 0) 

001 

Assign WRAM-Cx to the offset 1 memory region (slot 1) 

010 

Assign WRAM-Cx to the offset 2 memory region (slot 2) 

oil 

Assign WRAM-Cx to the offset 3 memory region (slot 3) 

100 

Assign WRAM-Cx to the offset 4 memory region (slot 4) 

101 

Assign WRAM-Cx to the offset 5 memory region (slot 5) 

110 

Assign WRAM-Cx to the offset 6 memory region (slot 6) 

111 

Assign WRAM-Cx to the offset 7 memory region (slot 7) 


• M[d25-d24][d17-d16][d09-d08][d01-d00]: Master Setting 

Specifies the master for each of the WRAM-C memory biocks. 




Set ARM9 as the master fer WRAM-Cx 


Set ARM7 as the master fer WRAM-Cx 


Set the DSP (data bus) as the master for WRAM-Cx 



MBK5: WRAM Bank Control Register 5 

Name: MBK5 Address: 0x04004050 Attribute: R/W Initial value: 0x00000000 



• WRAM-C[4-7] 

• E[d31][d23][d15][d07]: Enable Setting 

Seiects whether to enabie (1) or disabie (0) each of the WRAM-C memory biocks. 

• OF[d28-d26][d20-d18][d12-d10][d04-d02]: Offset Setting 

Specifies the assignment iocation (offset 0-7) for each of the WRAM-C memory biocks. 
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Effect of Settings 

000 

Assign WRAM-Cx to the offset 0 memory region (slot 0) 

001 

Assign WRAM-Cx to the offset 1 memory region (slot 1) 

010 

Assign WRAM-Cx to the offset 2 memory region (slot 2) 

oil 

Assign WRAM-Cx to the offset 3 memory region (slot 3) 

100 

Assign WRAM-Cx to the offset 4 memory region (slot 4) 

101 

Assign WRAM-Cx to the offset 5 memory region (slot 5) 

110 

Assign WRAM-Cx to the offset 6 memory region (slot 6) 

111 

Assign WRAM-Cx to the offset 7 memory region (slot 7) 


• M[d25-d24][d17-d16][d09-d08][d01-d00]: Master Setting 

Specifies the master for each of the WRAM-C memory biocks. 


Effect of Settings 

00 

Set ARM9 as the master for WRAM-Cx 

01 

Set ARM7 as the master for WRAM-Cx 

10 

Set the DSP (data bus) as the master for WRAM-Cx 

11 


Be sure to set different combinations of masters and offsets for each WRAM-B memory biock. 


For exampie: 


WRAM-CO 

Slot 

0 

on 

WRAM-C1 

Slot 

1 

on 

WRAM-C2 

Slot 

0 

on 

WRAM-C3 

Slot 

1 

on 

WRAM-C4 

Slot 

0 

on 

WRAM-C5 

Slot 

1 

on 

WRAM-C6 

Slot 

2 

on 

WRAM-C7 

Slot 

3 

on 


ARM9 (M=00, OF=000) 

ARM9 (M=00, OF=001) 

ARM7 (M=01, OF=000) 

ARM7 (M=01, OF=001) 

DSP (data bus) (M=10, OF=000) 
DSP (data bus) (M=10, OF=001) 
DSP (data bus) (M=10, OF=010) 
DSP (data bus) (M=10, OF=011) 


Next, set the region image size and the starting and ending addresses using WRAM Controi Register 8 
(MBK8) of the ARM9 and ARM7. 
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MBK8: WRAM Bank Control Register 8 

Name: MBK8 Address: 0x0400405C Attribute: R/W Initial value: 0x00000000 


31 28 19 13 12 11 30 
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EADDR 
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IS 

SADDR 
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□ 

□ 


WRAM-C 


• WRAM-C 

• EADDR[d28-d19]: End Address Setting 

Specifies the end address of the WRAM-C region. The address is specified in 32KB chunks. 
End Address = 0x02FFFFFF -h (EADDR « 15) (0x02FFFFFF-0x03FFFFFF) 

• IS[d13-d12]: Image Size Setting 

Specifies the image size of the WRAM-C region. 


Effect of Settings 


Repeat the WRAM-C slot 0 Image In 32KB units 


Repeat the WRAM-C slot 0-1 Images In 64KB units 


Repeat the WRAM-C slot 0-3 images in 128KB units 


Repeat the WRAM-C slot 0-7 images in 256KB units 


• Setting the image size to 32KB units (IS=00) 

0x04000000 


END 

Disabled region 

0X03FF8000 

SlotO 

0X03FF0000 

SlotO 

START 

Enabled region 

0x03030000 

Ac 

0x03028000 

SlotO 

0x03020000 

SlotO 

0x03018000 

SlotO 

0x03010000 

SlotO 


Disabled region 

0x03008000 

SlotO 

0x03000000 

SlotO 
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• Setting the image size to 64KB units (IS=01) 

0x04000000 


END 

Disabled region 

0X03FF8000 

Slot 1 

OxOSFFOOOO 

SlotO 

START 

Enabled region 

0x03030000 

Ac 

0x03028000 

Slot 1 

0x03020000 

SlotO 

0x03018000 

Slot 1 

0x03010000 

SlotO 


Disabled region 

0x03008000 

Slot 1 

0x03000000 

SlotO 


• Setting the image size to 128KB units (IS=10) 

0x04000000 


END 

Disabled region 

0X03FF8000 

Slot 3 

0X03FF0000 

Slot 2 

START 

Enabled region 

0x03030000 

Ac 

0x03028000 

Slot 1 

0x03020000 

SlotO 

0x03018000 

Slot 3 

0x03010000 

Slot 2 


Disabled region 

0x03008000 

Slot 1 

0x03000000 

SlotO 


• Setting the image size to 256KB units (IS=11) 

0x04000000 


END 

Disabled region 

0X03FF8000 

Slot? 

0X03FF0000 

Slots 

START 

Enabled region 

0x03030000 

Ac 

0x03028000 

Slots 

0x03020000 

Slot 4 

0x03018000 

Slot 3 

0x03010000 

Slot 2 


Disabled region 

0x03008000 

Slot 1 

0x03000000 

SlotO 
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• SADDR[d11-d03]: Start Address Setting 

Specifies the start address of the WRAM-C region. The address is specified in 32KB chunks. 
Start Address = 0x03000000 + (SADDR « 15) (0x03000000-0x03FF8000) 


If enabied regions overiap, they wiii be mapped with the priority WRAM-A > WRAM-B > WRAM-C, and 
WRAM-0/1 wiii be mapped to any disabied regions if no other shared RAM has been mapped. For access 
to siots to which no memory biocks have been assigned, writes are disabied, and reads wiii aiways return 
a 0. 


3.2.3 Work RAM Configuration in TWL SDK 

With TWL SDK, the WRAM manager in the memory interface iibrary handies the arbitration of requests to 
assign WRAM-A/B/C to each processor. 

WRAM-A (64 KB x 4) is compieteiy used by the ARM7, so its aiiocation cannot be changed. In contrast, the 
allocation of WRAM-B (32 KB x 8) and WRAM-C (32 KB x 8) can be changed flexibly between ARM9, 
ARM7, and the DSP. 

For details about the WRAM manager, refer to ‘Work RAM” in the Memory Interface Overview section of 
the TWL SDK Function Reference Manual. 

3.2.4 I/O Registers 

See the appendices to learn about the mapping for each I/O register. 

• Accessing undefined registers 

Table 3-17 shows the behaviors that occur when an undefined address is accessed in the I/O register 
regions. 


Table 3-17 : Result of Accessing an Undefined Register 


Access Destination 

Write 

Read 

Undefined Register 

Invalid 

ALL zero 
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3.3 Memory Map for Game Card Boot 

Figure 3-18 shows the memory map when the system boots from a Game Card. 

Figure 3-18 : Memory Map for Game Card Boot 
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The following are details about the regions shown in the memory map. Regions whose names inciude 
“Extended,” the Secure 2 Region, and the Game 2 Region have been extended in TWL. 

In Nitro compatibiiity mode, oniy 4 MB from the start of the main memory is enabied. There is no system 
reserved region at the start, and the ARM9 resident moduie can be iocated at the start of main memory. 

• Resident Moduie, Extended Resident Moduie: 

Loaded at appiication startup time. 

• Overiay Moduie, Extended Overiay Moduie: 

Loaded by the appiication itseif. 

• Data Binary, Extended Data Binary: 

Loaded by the appiication itseif. 

Not iinked; ioaded by referencing FAT. 

• The Header Region: 

Stores the ROM registration data. This data is ioaded into the System region of main memory at boot 
time. 

This region cannot be reioaded after appiication startup. 

(After the Game Code is determined) Provides a binary fiie caiied a ROM header tempiate for each 
appiication. 

• The Secure Region: 

Stores the starting part of the ARM9 Resident Moduie. This is ioaded at boot time to the address in 
main memory specified by the registration data in ROM. 

Must be iocated within the first 64 KB from the start of main memory, for security reasons. 

Decodes the first 2 KB, an encrypted region, when ioaded. 

To be specific, the encrypted system caii iibrary is iinked to the start when the ARM9 resident 
moduie is created. 

Because this cannot be reioaded after appiication startup, oniy the . text and . rodata sections 
shouid be iocated in the secure region. Otherwise, you cannot perform a software reset. 

• The Secure 2 Region: 

Stores the starting part of the ARM9 Extended Resident Moduie. This is ioaded at boot time to the 
address in main memory specified by the registration data in ROM. 

Like the Secure Region, it cannot be reioaded after appiication startup. 

• The Game Region: 

Loads (at boot time) the part of the ARM9 Resident Moduie that foiiows the Secure Region and the 
ARM7 Resident Moduie to the address specified by the registration data in ROM. 

Set the bootabie size for ARM9 so that it does not exceed 2.5 MB from the beginning of main memory 
(note that 16 KB wiii be subtracted for the System Reserved region). For ARM7, the bootabie region 
shouid not exceed 256 KB from address 0x02380000 in main memory. 

This region is aiways read-enabied. The appiication shouid ioad the Overiay Moduie and Data Binary 
as needed. 

• The Game 2 Region: 

Loads (at boot time) the part of the ARM9 Extended Resident Moduie that foiiows the Secure Region 
and the ARM7 Extended Resident Moduie to the address specified by the registration data in ROM. 

Set the bootabie size for ARM9 so that it does not exceed 4 MB from address 0x02400000 in main 
memory. For ARM7, the bootabie region shouid not exceed 1.03 KB starting from address 
0x02E80000 in main memory. 
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This region is aiways read-enabied. The appiication shouid ioad the Extended Overiay Moduie and 
Extended Data Binary as needed. 

Note: See the TWL Nintendo DS/DSi-Compatible/DSi Game Card Manual tor detaiis about the ROM 
Registration Data. 
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4 Main Processor Core (ARM946E-S) 

Figure 4-1 is a biock diagram of the main processor core. 

Figure 4-1 : Block Diagram of the Main Processor Core 



4.1 Protection Unit 

The Protection L/n/f protects memory by configuring the read/write attributes and enabiing/disabiing the 
use of the cache and Write buffers in each protection region. 

Up to eight memory regions can be configured from the 4 GB of background (the entire address space 
accessibie from the CPU). Protection regions with higher region numbers have higher priority. (If regions 
have dupiicate protection region settings, the setting with the higher protection region number is given 
priority.) Each protection region can be configured separateiy to enabie/disabie the cache and Write 
buffers and aiiow/disaiiow reading/writing. 

• Debug Version and Release Version 

In addition to the production version of TWL, there is a debug version that comes with the main 
memory expanded to 32 MB. Though part of the additionai 16 MB of main memory is used as the 
debugger region, the remainder can be used during appiication deveiopment. Because the debug and 
reiease versions of TWL have different memory structures, the Protection Unit settings are aiso 
different. 
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4.2 Tightly Coupled Memory (TCM) 

TCM is high-speed memory that is directiy connected to the ARM9 core. It can be used as independent 
Work RAM. Because TCM does not use the ARM9 bus, ARM9 can use TCM to conduct processes even 
whiie the ARM9 bus is being used (such as by DMA). 

As a resuit, TCM can boost performance by storing frequentiy used programs and data that you want to 
access during DMA transfers. 

There are two types of TCM: one for instructions and one for data. Note that TCM cannot be accessed via 
DMA. 

4.2.1 Instruction TCM 

This is 32 KB of high-speed memory, mapped from ARM9 address 0x01 FF8000. 

Instruction TCM is a good piace to hoid fast-running programs or programs for which you want to fix the 
operation ciock count. Exampies inciude graphic iibraries and routines that branch on interrupts. 

Because Instruction TCM does not require the ARM9 bus whiie fetching instructions. Instruction TCM is 
aiso an effective piace to store programs you want to execute whiie DMA is using the ARM9 bus. 
Exampies inciude routines that generate dispiay iists and computation routines. 

You can store data in Instruction TCM memory aiso, but staiis occur when data access coiiides with 
instruction fetches. 

4.2.2 Data TCM 

This is 16 KB of high-speed memory. Data TCM can be set to any address iocation in the memory map. 

Data TCM is a good piace to store data for fast reading and writing. Exampies inciude stacks and 
frequentiy accessed tabies. 

Because Data TCM does not require the ARM9 bus during access. Data TCM can be used for creating the 
next dispiay iist even whiie the current dispiay iist is being transferred via DMA from main memory to the 
geometry engine. 

However, transfers from TCM must be conducted via the ARM9 core. In addition, instructions cannot be 
piaced in Data TCM. But that means there is no staiiing of data access due to coiiisions with instruction 
fetches. 

4.3 Cache Memory 

When the ARM9 bus references memory, it takes 32 bytes of data from that vicinity (the data in a range 
corresponding to the upper 27 bits of the referenced address) and ioads that data into the cache so the 
data is accessibie at the fast speeds of cache memory the next time that range is referenced. 

If the ARM9 hits data that is in the cache, the data can be read quickiy. 

If the ARM9 does not hit data in the cache, the contents of memory are read in units of cache iines (iine 
fetching). During this process, the contents of the cache iines are repiaced according to the repiacement 
aigorithm. 

Note that the Protection Unit must be enabied to use the cache. 

Tabie 4-1 iists the specifications for the cache. 
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Table 4-1 : Cache Specifications 


Capacity 

Instruction cache: 8 KB 

Data cache: 4 KB 

Configuration 

4-way set associative method 

Cache Line 

8 words (32 bytes) 

Write-miss Operation 

Read-allocate method (see note 1) 

Replacement 

Can choose either round-robin (see note 2) or pseudo-random 

Algorithm 

(see note 3) 

Bus Snoop Feature 
(see note 4) 

None 

Other Features 

Lockdown 

(Instruction Cache) 

Instruction prefetch 

Other Features 

Lockdown 

(Data Cache) 

Write-through mode / Write-back mode 


Note 1 : Read-allocate methods 

In this method, when there is a write miss, the write is performed oniy for the memory (or for the 
Write buffer, if it is enabied). Data is not ioaded to the cache. (For the Write-aiiocation method, a 
write miss is bandied as a write hit after data is ioaded into the cache.) 

Note 2: Round-robin (recommended) 

In this method, cache iines are repiaced in order. Performance is stabie in the worst-case scenario. 
Note 3: Pseudo-random 

In this method, cache iines are repiaced randomiy. This increases peak-time performance, but 
iowers worst-case performance. 

Note 4: Bus Snoop feature 

By monitoring the bus, this feature detects whether another processor or DMA writes to the memory 
region stored in the cache. Because the ARM946E-S does not have this feature, you must be carefui 
that there is coherency between memory and cache. (See "4.5 Ensuring Coherency" on page 67 .) 

4.3.1 Instruction Cache 

This is 8 KB of high-speed memory, dedicated to instruction code. 

The ARM9 bus is not used during cache hits, so a program in the Instruction cache can run even when a 
non-ARM9 bus master (DMA or subprocessor) has possession of the ARM9 bus. 

4.3.1.1 Determining Hits and Misses 

When the ARM9 bus fetches instruction code from memory, the Instruction Cache Controiier extracts the 
Index bit and TAG bit from the memory addresses and compares the contents of TAG RAM in the nth 
cache iine (defined by the Index number) with the TAG bit at that memory address. Because the 
ARM946E-S cache has a four-set structure, the comparison is made on four cache iines. If the comparison 
finds a match for any of these four cache iines and the vaiid bit is enabied, it is determined that the cache 
iine contains the targeted instruction code (a hit). If not, it is considered a miss. 

For a cache hit, the intended instruction code in Data RAM is identified from the address' Word or Byte and 
can be accessed quickiy. For a miss, the cache iines are fetched from memory via the ARM9 bus. 

Figure 4-2 shows the structure and actions of the Instruction cache. 
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Figure 4-2 : Structure and Actions of the Instruction Cache 


(Sets 0 to 3 have the same architecture) 



Address of instruction that ARM9 will fetch 


About Instruction Cache TAG RAM 

• TAG 

The upper 21 bits of the memory address of the data in the cache iine are stored here. 

• Fiag 

Generated from the valid b'\l, which indicates whether cache iines are enabied or disabied. 

4.3.2 Data Cache 

This is 4 KB of high-speed memory. It is data-oniy. 

The ARM9 bus is not used during cache hits, so the data in this cache can be accessed even when a non- 
ARM9 bus master (DMA or subprocessor) has possession of the ARM9 bus. 
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4.3.2.1 Determining Hits and Misses 

When ARM9 loads data into memory, the Data Cache Controller extracts the Index bit and TAG bit from 
the memory address and compares the contents of TAG RAM in the nth cache iine (defined by the index 
number) with the TAG bit at the memory address. The ARM946E-S cache has a four-set structure, so the 
comparison is made on four cache iines. If the comparison finds a match for any of these four cache iines 
and the vaiid bit is enabied, it is determined that the cache iine contains the targeted data (hit). If not, it is 
considered a miss. 

For a cache hit, the targeted data in data RAM is identified from the address' Word and Byte and can be 
quickiy accessed. For a miss, the data is accessed from memory via the ARM9 bus. 

Figure 4-3 shows the structure and actions of the Data cache. 

Figure 4-3 : Structure and Actions of the Data Cache 


(Sets 0 to 3 have the same architecture) 



Address of data that ARM9 will read/write 

(Differs from Instruction cache in that the Index Is 5 bits) 
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About Data Cache TAG RAM 

• TAG 

The upper 22 bits of the memory address of the data in the cache iine are stored here. 

• Fiag 

Consists of the vaiid bit, which indicates whether cache iines are enabied or disabied, the dirty bit for 
the first haif of the iine, and the dirty bit for the second haif of the iine, which indicate whether the 
contents of the cache and memory are the same. 

When the contents of the cache match those in memory, the cache is said to be clean. When the 
contents do not match, the cache is dirty. 

The dirty bits are used oniy in write-back mode. To read more about this mode, see "4.4 Write Buffer" 
on page 66 . 

The dirty bits are referenced when the contents of a iine are to be written back to memory. If the flag is 
dirty, a write-back occurs. If the flag is clean, no write-back occurs (because it is unnecessary). 

4.3.3 Cache Operations 

Table 4-2 shows the operations conducted on the cache. Some operations act on the entire cache, while 
other operations act on specified cache sets, specified cache lines, or a particular cache line specified by a 
memory address. 


Table 4-2 : Cache Operations 


Cache Operation 

Instruction Cache 

Data Cache 

Overall Direct Operations 

- Enable/Disable 

- Enable/Disable 

- Invalidate 

- Invalidate 

Direct Operations on Sets 

- Lockdown 

- Lockdown 

Direct Operations on Lines 

— 

- Clean 

- Clean & Invalidate 

Operations on Cache Lines 

- Prefetch 

- Clean 

Corresponding to Memory 
Addresses 

- Invalidate 

- Invalidate 
- Clean & Invalidate 


The Clean, Invalidate, and Clean & Invalidate operabons can cause changes in the usage state of cache. 
To read more about these changes, see "4.5 Ensuring Coherency" on page 67 . 

About Each Operation 

• Clean 

Writes back dirty data in the cache to memory. The data remains in the cache. If the Write buffer is 
enabled, the actual write back to memory is delayed. 

• Invalidate 

Invalidates the data in the cache. The next time this memory region is read, a read miss occurs and a 
line fetch from memory to the cache is performed. The data moved into the cache by the line fetch is 
treated as valid. 

• Clean & Invalidate 

Writes back dirty data in the cache to memory and invalidates the data in the cache. As a result, the 
next time this memory region is accessed, the data will be line-fetched from memory to the cache. 

Caution: If the write buffer (refer to "4.4 Write Buffer" on page 66 for details) is full and the Clean & 
Invalidate command is issued, caches that are already clean will not be invalidated. 
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• Instruction Prefetch (prefetch) 

Takes instruction code that has not yet been fetched by the program and preioads it into the Instruction 
cache. It uses coprocessor instructions. 

• Lockdown 

By iocking down one set of cache, no iine in that set can be repiaced by iine fetches and the whoie set 
can be used as a biock of Work RAM. However, this reduces the cache region by the same amount 
and increases the miss rate. 

• Enabie/Disabie 

When using the cache, in addition to enabiing the cache, you must aiso enabie the Protection Unit. 

You can enabie/disabie the Instruction cache and the Data cache for each protection region. To read about 
protection regions and their settings, see "4.1 Protection Unit" on oaoe 59 . 

Caution: Data Preioad (preioad) is a feature that preioads data that has not been accessed by the 

program and normaiiy operates by using the PLD instruction. However, due to ARM946E-S 
specifications, no operation wiii be performed even when a PLD instruction is recognized. 
Therefore, the data preioad feature does not work with ARM946E-S. 

4.3.4 Optimizing the Cache 

The cache uses the memory reference iocaiity of most programs to acceierate memory access. 

Temporal locality The high probabiiity that data, once referenced, wiii be referenced again soon. 

Spatial locality The high probabiiity that data near referenced data wiii aiso be referenced. 

Programs with a higher reference iocaiity have higher cache hit rates and faster average access speeds. 

Depending on how a program is pieced together, you can manuaiiy increase the reference iocaiity to some 
extent. For exampie, when constructing a ioop to handie a two-dimensionai (or higher) array, you can 
boost the spatiai iocaiity of the array by handiing addresses in consecutive order. 

Examples: 


Loop Example A 

Loop Example B 

u32 RESULT, TEST [0x100] [0x100] ; 

u32 

RESULT, TEST[0x100] [0x100]; 

for ( j = 0; j <0x100; j-n-) { 

for 

i=0; i<0xl00; i++) { 

for( i=0; i<0xl00; i++) { 


for( j=0; j<0x100; j++) { 

RESULT += TEST[i] [j] ; 

} 

} 

} 

RESULT += TEST[i] [j]; 

} 


In loop example A, the TEST array is referenced every 0x100 addresses inside the loop, so there is no 
cache hit during the first iteration. Lines are fetched one after another in the first iteration. However, 
because the capacity of the Data cache is 32 lines x 4 sets for a total of 128 lines (0x80 lines), the entire 
loop does not fit in the Data cache, and hits occur only half the time in the second and subsequent 
iterations. 

In contrast, in loop example B, the TEST array is referenced in the same order as the addresses inside the 
loop, enabling the maximum hit rate. 
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4.4 Write Buffer 

The Write buffer is 32 bytes x 16 iayers of FIFO memory that integrates addresses and data. 

The type of entry is determined by the address/data fiag. Address entries have an appended data size. 

Writing data to the high-speed Write buffer instead of memory keeps ARM9 from staiiing during the write 
process. However, ARM9 wiii staii when writing to the Write buffer when it is fuii. 

When the Protection Unit is enabied, you can seiect among the access modes shown in Tabie 4-3 for 
writing data. The seiection is made by configuring the Data cache and the Write buffer for each protection 
region as shown. 

To read more about protection regions, see "4.1 Protection Unit" on page 59 . 


Table 4-3 : Access Modes When the Data is Being Written 


Data Cache Setting 

Write Buffer Setting 

Access Mode 

Disable 

Disable 

NCNB mode® 

(Data cache and Write buffer are both disabled) 

Disable 

Enable 

NCB mode 

(Data cache disabled; Write buffer enabled) 

Enable 

Disable^ 

Write-through mode 

Enable 

Enable 

Write-back mode 


a. In NCNB mode, the contents of the write buffer are output when writing and are accessed ahead of the Write 
buffer output when reading. 

b. In write-through mode, the Write buffer is disabled, but it is used. 


• Write-back mode (recommended) 

If there is a hit during the data write, data is written oniy to the cache and not to the Write buffer. 
Therefore, the contents of the cache may not be the same as in memory, but writing is fast. 

A C/ean operation must be performed in order for the data rewritten by the CPU to be refiected in 
memory. 

Further, when a read-miss occurs whiie the cache is fuii and the cache iines to be emptied by the 
repiacement aigorithm are dirty, they are written back to the Write buffer. 

• Write-through mode 

If there is a hit during the data write, the data is written to the Write buffer at the same time that it is 
written to the cache. Therefore, the cache iine does not become dirty as a resuit of writing to ARM9, 
but writing is siow. 

Further, if the cache is fuii when a read-miss occurs, the repiacement aigorithm overwrites the cache 
iine. 

In both of these modes, data is written oniy to the Write buffer when a write-miss occurs. 

Aiso, if a iine is being fetched, the contents of the Write buffer are discharged first to maintain data 
coherency. 

Note: Be carefui about the access width of memory when writing in write-through mode. (For exampie, 
you cannot use an access width of 8 bits with VRAM.) To read about the access width for each 
memory type, see "3 Memory" on page 17 . 

To read about cache state transitions and controi in either of these modes, see "4.5 Ensuring 
Coherency" on page 67 . 
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4.4.1 Write Buffer Operations 

• Wait for the Write buffer to empty 

The ARM9 bus can staii untii aii data in the Write buffer is written to memory. 

Use this operation to make certain that aii content rewritten by the CPU is refiected in memory. 

Note that this operation is not necessary when data is written to I/O registers or other regions where 
cache and buffers are disabied, because in these cases, the CPU stops untii the Write buffer is empty. 

To read why this operation is necessary in other cases, see "4.5 Ensuring Coherency" on page 67 . 

4.5 Ensuring Coherency 

Be carefui when using the cache to make sure no inconsistencies arise between the contents of the cache 
and memory. 

The cache state is managed in each cache iine by the fiag in TAG RAM. 

This fiag inciudes one validbW and two dirty bUs. The dirty bits indicate the state of the first haif and second 
haif of the cache iine. Aii three bits are used for the Data cache in the write-back mode, but oniy the vaiid 
bit is used in the write-through mode or for the Instruction cache. 

4.5.1 Write-Back Mode 

Tabie 4-4 shows how the fiag states define the cache iine state in write-back mode. 


Table 4-4 : Cache Line States (Write-Back Mode) 


State 

Flag State 

Description 

Valid 

Dirty 

Dirty 

1 

1 

Cache line is valid, contents differ from memory 

Clean 

1 

0 

Cache line is valid, contents match memory 

Invalid 

0 

* 

Cache line is invalid 


Operations Managed Automatically by the Cache Controller 

As shown in Figure 4-4, read misses/hits and write misses/hits on access from the ARM9 as weii as state 
transitions by the repiacement aigorithm are performed automaticaiiy. 

When the repiacement aigorithm repiaces vaiid but dirty iines, the iines are first written back to memory (or 
to the Write buffer, if enabied). Because the process is actuaiiy conducted on the first and second haives of 
the iine, and not on the entire iine, the voiume of data written back can be 0, 16, or 32 bytes. 

Operations that Must be Managed by the User 

Because the ARM946E-S iacks the bus snoop feature, when cached memory is accessed by a bus master 
other than ARM9 (such as the subprocessor or DMA), the cache iines must be operated manuaiiy. 

When data are written to memory by a bus master other than ARM9, invaiidate the appropriate cache 
iines. 

Aiso, when memory is read by a bus master other than ARM9, you shouid ciean the cache iine beforehand 
and perform the Wait for the Write buffer to empty operation. 
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Figure 4-4 : Cache Line State Transitions (Write-Back Mode) 


Line Fetch due to 
Read Miss 



Example 

• If the program in main memory is overwritten by an overiay, etc. 

Invaiidate the Instruction cache in the appropriate region. 

4.5.2 Write-Through Mode 

Tabie 4-5 shows how the fiag states define the cache iine state in write-through mode. 


Table 4-5 : Cache Line States (Write-Through Mode) 


State 

Flag State 

Description 

Valid 

Dirty 

Clean 

1 

* 

Cache line Is valid, contents match memory 

Invalid 

0 

* 

Cache line Is Invalid 


Operations Managed Automatically by the Cache Controller 

As shown in Figure 4-5, read misses/hits and write misses/hits for access from the ARM9 as weii as state 
transitions by the repiacement aigorithm are performed automaticaiiy. 

Operations that Must be Managed by the User 

Because the ARM946E-S iacks the bus snoop feature, when cached memory is accessed by a bus master 
other than ARM9 (such as the subprocessor, DMA, etc.), the cache iines must be operated manuaiiy. 

When data are written to memory by a bus master other than ARM9, you shouid invaiidate the appropriate 
cache iines. 

Aiso, when memory is read by a bus master other than ARM9, perform the Wait for the Write buffer to 
empty operation. 
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Figure 4-5 : Cache Line State Transitions (Write-Through Mode) 



- Invalidate 


Example 

• If the program in main memory is overwritten by an overiay, etc. 
Invaiidate the Instruction cache in the appropriate region. 
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5 Display 

Note: There are no changes to this chapter other than the addition of the INI bit to the dispiay status. 

5.1 Display System 

The dispiay system biock diagram is shown in " Figure 5-1 : Dispiav System Biock Diagram " on page 72. 
Each seiector in the biock diagram can be controiied using the register seiection fiags in Tabie 5-1. 


Table 5-1 : Selector and Register Selection Flag Map 


Selector Name 

Register Name 

Flag Name 

SEL DISP 

DISPCNT 

Display mode selection 

SEL BGO 

DISPCNT 

2D/3D display selection for BGO 

SEL DISP VRAM 

DISPCNT 

Display VRAM Selection 

SEL A 

DISPCAPCNT 

Capture source A selection 

SEL B 

DISPCAPCNT 

Capture source B selection 

SEL CAP 

DISPCAPCNT 

Capture mode selection 

SEL CAP VRAM 

DISPCAPCNT 

Capture data write destination VRAM selection 

SEL LCD 

POWCNT 

LCD output destination switch 


After seiecting the graphics dispiay, VRAM dispiay, or main memory dispiay using SEL DISP, the image 
output becomes Image Output A. 

Similarly, the image output of the 2D graphics engine B becomes Image Output B. 

Image Outputs A and B each go through Master Brightness Up/Down A and B, respectively, and become 
the Display Output A and Display Output B that are sent to the LCD. 

When finally output to the LCD, these display outputs cannot be layered. 

Choose one of the following: 

• Send Display Output A to the Upper Screen LCD and send Display Output B to the Lower Screen LCD 

• Send Display Output A to the Lower Screen LCD and send Display Output B to the Upper Screen LCD 
For games that require only one LCD, disable the LCD display you do not use. 

For further details, see "11 Power Management" on page 317 . 

Image Output A allows you to blend and display 2D graphics and 3D graphics in the graphics display. 

See "7 3D Graphics" on page 177 for information on the hardware block for 3D image creation. 
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Figure 5-1 : Display System Block Diagram 



Capture 


'BEL CAP VRAN 


VRAM A 

- 

< 

\/RAM R 

- 

V IxMlVI D 


Si 

VRAM C 


vr\/Aivi 

W 

LU 

VRAM D 

— 


VRAM Display 


Blending 


< 


c 




o 


Q 




D 


(/) 


(/) 

1 


1 


< 

O) 



Q. 


0 

o 

(/) 

>s 

CD 

CC 


Q. 


(/) 


Q 



DMA 

Main Memory 



Display FIFO 


Main Memory Display 


2D Graphics 
Engine B 


■o 

CQ 

w 

o 

<D 

c 

Hz 

CD 

LU 

D) 

C 

TO 


O 

<D 

<D 

>s 

Q. 

CD 

U) 

_l 



O 

O 

O 


CQ 


c 




o 


Q 


Q. 


=) 


(/) 


(/) 


C 

CQ ’ 



05 



Q. 

CD 

D 

0 

o 


>s 

CD 

03 


Q. 


W 


Q 


TWL-06-0017-001-D 
Released: February 16, 2009 


) 2008-2009 Nintendo 
CONFIDENTIAL 






















TWL Programming Manual 


5.2 LCD 

The specifications for the two LCD controiiers inciuded on the TWL are shown beiow. 


5.2.1 LCD Controller Specifications 

The LCD ciock specifications of the LCD controiier are shown in Tabie 5-2, the LCD scan timing is shown 
in Figure 5-2, and the specifications for the LCD scan timing are shown in " Tabie 5-3 : LCD Scan Timing 
Specifications " on page 74. 


Table 5-2 : LCD Clock Specifications 


LCD Clock 

Frequency (time) 

image Processing Clock 

33.513982 Mhz (29.838293 ns) 

Dot Clock 

5.585664 Mhz (179.029757 ns) (see note) 


Note: The Dot Clock is 1/6 of the Image Processing Clock. 


Figure 5-2 : LCD Scan Timing 


-355 dots- 


-256 dots- 


-99 dots- 


CM 

o 


Display Screen 


H-Blank 


A. 


V-Blank 


© 2008-2009 Nintendo 
CONFIDENTIAL 


73 


TWL-06-0017-001-D 
Released: February 16, 2009 






















TWL Programming Manual 


Table 5-3 : LCD Scan Timing Specifications 


Item 

Spec 

Period 

Reference: AGB Value 

Display 

Horizontal Dot Count 

256 dots 

45.8316 I.IS 

240 dots (57.221 |as) 

Screen Size 

Vertical Line Count 

192 lines 

12.2027 ms 

160 lines (11.749 ms) 

Total Dot 

Horizontal Dot Count 

355 dots 

63.5556 |is 

308 dots (73.433 |as) 

Count 

Vertical Line Count 

263 lines 

16.7151 ms 

228 lines (16.743 ms) 

Blanking 

H-Blank Dot Count 

99 dots 

17.7239 |is 

68 dots (16.212 |.rs) 


V-Blank Line Count 

71 lines 

4.5124 ms 

68 lines (4.994 ms) 


H-Cycle 

15.7343 KHz 

63.5556 |is 

13.618 KHz (73.443 ns) 


V-Cycle 

59.8261 Hz 

16.7151 ms 

59.727 Hz (16.743 ms) 


The V-Blank cycle for the 3D rendering engine consists of 23 lines: 191-213. For details, see "7.3 
Rendering Engine" on page 251 . 
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5.3 Display Status 

DISPSTAT: Display Status Register 

Name: DISPSTAT Address: 0x04000004 Attribute: R/W Initial value: 0x0000 



• [d15-d07] : V-Counter Match Setting Values 

Note that VC8 is iocated in d07 (for compatibiiity with AGB). Vaiues between 0 and 262 can be set. 
Proper operation is not guaranteed for a vaiue of 263 or higher. 

• INI [d06] : LCD Initialization Signal 


0 

LCD Initialize State 

1 

LCD Display State 


Writing to this bit is disabled. If the extended features are turned off in the system configuration, the 
value of this bit will be fixed at 0. 

• [d05-d03] : Interrupt Request Enable Flags 

• VQI[d05] : V-Counter match interrupt request enable flag 



When enabled, H-Blank interrupts are permitted with the Interrupt Enable Register (IE). H-Blank 
interrupts can be made during the display interval, and also during any of the 263 vertical lines 
(Line 0 - 262) on the LCD, including V-Blank intervals. 

• VBI[d03] : V-Blank interrupt request enable flag 



Disable 


Enable 


• [d02-d00] : Status Flag 

• LYC[d02] : V-Counter match detection flag 



Outside a matching interval 


During a matching interval 
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• HBLK[d01] : H-Blank detection flag 


0 

Outside H-Blank Interval 

1 

During H-Blank Interval 


• VBLK[dOO] : V-Blank detection flag 


0 

Outside V-Blank Interval 

1 

During V-Blank Interval 


Note: V-Blank detection flag is set to 1 at the moment it reaches Line 192 and is set to 0 when it reaches 
Line 262. This is because the OBJ rendering circuitry accesses OBJ-VRAM and 0AM starting at 
Line 262, which is one line before the actual display. In addition, the timing that ends access to 
OBJ-VRAM and 0AM depends on whether the OBJ process is performed during H-Blank. On the 
other hand, BG-VRAM, BG Palette RAM, and OBJ Palette RAM begin access at Line 0 and end at 
Line 191. This is summarized in Table 5-4. 


Table 5-4 : Period when Graphics Engines Access Memory 


Memory Accessed by Graphics Engines 

V-Counter Vaiue 

Access period when OBJ render¬ 
ing circuitry accesses OBJ-VRAM 
and 0AM 

Perform OBJ process during H-Blank 

0-191,262 

Does not perform OBJ process during 
H-Blank 

0-190, 262 

Access period when rendering circuitry accesses BG-VRAM, BG Palette 
RAM, and OBJ Palette RAM 

0-191 

(Reference) Period when the V-Blank deflection flag becomes 1 

192-261 
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VCOUNT: V-Counter Register 

Name: VCOUNT Address: 0x04000006 Attribute: R/W Initial value: 0x0000 


15 









V8 

V7 

V6 

V5 

V4 

V3 

V2 

VI 

VO 








V-Counter Values 


• [d08-d00] : V-Counter Values 

Unlike the bit arrangement of the V-Counter Match Setting Vaiues in the DISPSTAT register, these bits 
are in a normai arrangement. 

1. When reading values 

Can read which of the LCD's totai 263 iines is currentiy dispiayed. The readout vaiue is between 0 
and 262. 

If the readout value is between 0 and 191, images are being drawn. If the value is between 192 
and 262, it is a V-Blank period. 

To learn about the LCD's display timing, see "5.2 LCD" on page 73 . 

2. When writing values 

Written values are reflected when the hardware's V-Counter is updated. 

By using this register, you can synchronize all TWL V cycles by adjusting the V-count value when 
communicating among multiple TWL devices. 

Confirm that the current value of the V-Counter is between 202 and 212 and write values only 
between 202 and 212. Proper operation of the 3D engine is not guaranteed when writing values 
outside this range. 

Note: When there is a conflict between the access to the display circuit VRAM and the access to VRAM 
from the CPU, the display circuit VRAM takes precedence. 

Because the dot clock of the LCD controller is 1/6 of a cycle of the image processing clock and the 
system clock, the timing for the LCD controller to access the VRAM is once every six cycles. 

With this timing, when simultaneously accessing from the CPU, the CPU access must wait for one 
cycle. 
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5.4 Display Control 

5.4.1 Top LCD/Bottom LCD Output Switching 

POWCNT: Power Control Register 

Name: POWCNT Address: 0x04000304 Attributes: R/W Initial Value: 0x0000 


15 


DSEL 






2DGB 






GE 

RE 

2DGA 

MDE 


















LCD Output Destination 
Switching Flag 


• DSEL[d15] : LCD Output Switching Fiag 


0 

Send Display Output A to the Lower Screen LCD 

Send Display Output B to the Upper Screen LCD 

1 

Send Display Output A to the Upper Screen LCD 

Send Display Output B to the Lower Screen LCD 


You can switch the LCD output destination with no deiay by configuring the Power Controi Register. 
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5.4.2 Display Control of 2D Graphics Engine A 

DISPCNT: Display Control Register 

Name: DISPCNT Address: 0x04000000 Attribute: R/W Initial value: 0x00000000 



Display Mode 


2D/3D Display 
Selection for BGO 


Display VRAM 


OBJ Mapping 
Mode 


OBJ Process During 
H-Blank Period 


2D Display 
Forced Blank 


BG Character 
Base Offset 


BG Screen 
Base Offset 


Extended Palette 


• [d19-d18] : Display VRAM 

Selects the VRAM block to display when in VRAM Dispiay Mode (see “ rd17-d161: Dispiav mode ”). 


00 

VRAM-A 

01 

VRAM-B 

10 

VRAM-C 

11 

VRAM-D 


• [d17-d16] : Dispiay mode 

When the Dispiay mode is OFF, 2D/3D graphics, VRAM dispiay, and main memory dispiay are not 
seiected and appear white. 

Graphics dispiay mode dispiays both 2D and 3D graphics. 

VRAM dispiay mode dispiays the bitmap data stored in VRAM. 

Main memory dispiay mode dispiays the bitmap data stored in main memory (requires a DMA setting). 
For detaiis, see the appropriate sections. 


0 

Display OFF 

1 

Graphics Dispiay 

2 

3 

VRAM Dispiay 

Main Memory Dispiay 
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• [d07] : 2D Display Forced Blank 

The 2D graphics display is forcibly halted by the CPU. Because 2D display is halted, 3D graphics 
using BGO are not displayed either. 

During a forced blank, the 2D graphics circuitry does not access VRAM, and the LCD screen is white. 

However, even during a forced blank, the internal HV synchronization counter continues to run. 

If the forced-blank setting is changed from ON to OFF during a display period of the internal HV 
synchronization counter, the effect takes place immediately; if it is changed from OFF to ON, the 
switch takes place at the start after three lines. 

• [d03] : 2D/3D Display Selection for BGO 

This bit determines whether to use one of the BG screens (BGO) for 2D graphics or for 3D graphics. 

When 3D graphics are selected, the 2D graphics features for BGO are limited and the specifications for 
color special effects change. See "7.4 2D Graphics Features You Can Apply to the 3D Screen After 
Rendering" on page 293 . 


0 

Display 2D graphics 

1 

Display 3D graphics 


• Other bits 

The bits in the DISPCNT register not covered above are explained in the following sections: 

Bits related to the display control of 2D graphics features are explained in "6 2D Graphics" on page 97 . 
Bits related to BG are explained in "6.2 BG" on page 101 . 

Bits related to OBJ are explained in "6.3 OBJ" on page 133 . 


TWL-06-0017-001-D 
Released: February 16, 2009 


80 


© 2008-2009 Nintendo 
CONFIDENTIAL 












TWL Programming Manual 


5.4.3 2D Graphics Engine B Dispiay Controis 

DB_DISPCNT: Display Control Register 1 

Name: DB DISPCNT Address: 0x04001000 Attributes: R/W Initial Value: 0x00000000 



• [d16] : Display Mode 



Display OFF 


Display ON 


• [d07] : 2D Display Forced Blank 

This forcibiy stops the 2D graphics engine circuit using the CPU. 

During a forced biank, the 2D graphics circuit does not access the VRAM, and the LCD screen 
appears white. 

However, the internai HV synchronization counter runs even during a forced biank. 

If the internai HV counter changes a forced biank during the dispiay intervai, the ON/OFF switches 
immediateiy after configuration when going from ON to OFF or switches from the top after three iines 
when going from OFF to ON. 
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5.4.4 Display Modes 

As indicated in Tabie 5-5, on the Dispiay Output A side (the 2D Graphics Engine A), there are modes that 
dispiay the bitmap data in the VRAM and main memory in addition to the mode that dispiays the images 
generated by the graphics circuit. 


Table 5-5 : Overview of the Display Modes (2D Graphics Engine A) 


Display Mode 


ni^nl^x/ 

Fr^mp 

Features 

Number 

Display Mode 

Size 

Rate 

3D 

Display 

Character 
BG Display 

Bitmap BG 
Display 

OBJ 

Display 

0 

Display OFF 

- 

- 

- 

- 

- 

- 

1 

Graphics Display 

256x192 

60 fps 

X 

X 

X 

X 

2 

VRAM Display 

256x192 

60 fps 



X 


3 

Main Memory Display 

256x192 

60 fps 



X 



As indicated in Tabie 5-6, on the Dispiay Output B side (the 2D graphics engine B), the oniy mode 
seiection is graphics dispiay ON or OFF. 

Table 5-6 : Overview of the Display Modes (2D Graphics Engine B) 


Display Mode 


Display 

Frama 

Feature 

Number 

Display Mode 

Size " 

Rate 

Character 
BG Display 

Bitmap BG 
Display 

OBJ 

Display 

0 

Display OFF 

- 

- 

- 

- 

- 

1 

Graphics Display 

256x192 

60 fps 

X 

X 

X 


" Figure 5-3 : Dispiav Mode Seiection (Dispiav Output A Side Oniv) " on page 83 is a simpiified version of 
the dispiay mode for Dispiay Output A in " Figure 5-1 : Dispiav System Biock Diagram " on page 72. 
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Figure 5-3 : Display Mode Selection (Display Output A Side Only) 
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5.4.4.1 Graphics Display Mode 

This mode displays images generated with the 2D and 3D graphics features. 

See " Figure 5-1 : Display System Block Diagram " on page 72 for information about the entire display 
system. 

To read about the various graphic features, see "6 2D Graphics" on page 97 and "7 3D Graphics" on page 177 . 

• Graphics display mode - Example 1 

The example in Figure 5-4 shows how the results of 3D rendering are layered with the 2D screen and 
displayed. 

Although 3D display is handled as the BGO screen, the 2D graphics features of BGO are limited, and the 
color special effect specifications have changed. See "7.4 2D Graphics Features You Can Apply to the 3D 
Screen After Rendering" on pace 293 . 

Figure 5-4 : Display Mode Selection (Display Output A Side Only) 
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• Graphics display mode - Example 2 

In the example shown in " Figure 5-5 : Example of Displavina the Bitmap OBJ Results of 3D Rendering " 
on page 86, the results of 3D rendering are pasted in a bitmap OBJ and displayed. 

The rendering engine's clear alpha value is set to 0, and the 3D rendering result is captured. Then, in 
the next frame, the VRAM is assigned to a bitmap OBJ, according to the value of the RAM Bank 
Control register. This enables the 3D rendering result to be displayed as an OBJ. 

At this moment in the sequence, alpha value segments that remain 0 in the 3D alpha-blending process 
are transparent. (See "7.3.7 Aloha-Blendino" on oaoe 283 for the capture feature and the rendering 
engine.) 

In this example, double buffering occurs by alternately assigning VRAM-A and VRAM-B to LCDC and 
OBJ-VRAM. 
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Figure 5-5 : Example of Displaying the Bitmap OBJ Results of 3D Rendering 
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5.4.4.2 VRAM Display Mode 

When the DISPCNT register is set for VRAM dispiay mode, one frame of bitmap data stored in a VRAM 
biock is shown from the start of the next dispiay. The DISPCNT register can specify which VRAM biock to 
use. 

VRAM is dispiayed using a different system than the 2D circuitry and the 3D circuitry, so when the mode is 
set to VRAM dispiay mode, images can be created by the graphics circuitry and captured to VRAM at the 
same time that images are being dispiayed. (See " Figure 5-1 : Dispiay System Biock Diagram " on page 
72). 

You can specify the same VRAM biock for dispiay and for capturing images. 

For detaiis about capturing images, see "5.5 Dispiav Capture " on page 91. 

The pixei data format for VRAM dispiay mode is shown beiow. 

VRAM Display Mode Data Format 


15 14_10 9 8 I 7_5 4_0 



BLUE 

GREEN 

RED 


Pixel Color Data 


Figure 5-6 shows the VRAM address map of the LCD pixeis. 

Figure 5-6 : VRAM Address Map of the LCD Pixels 
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3FAh 
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2 

400h 

402h 





5FCh 
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3 

600h 
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7FCh 
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4 

800h 







9FEh 


187 

17600h 







177FEh 

188 

17800h 

17802h 





179FCh 

179FEh 

189 

17A00h 

17A02h 





17BFCh 

17BFEh 

190 

17C00h 

17C02h 

17C04h 

17C06h 


17DFAh 

17DFCh 

17DFEh 

191 

17E00h 

17E02h 

17E04h 

17E06h 


17FFAh 

17FFCh 

17FFEh 


• VRAM dispiay mode - Exampie 

In " Figure 5-7 : Example of the Motion Blur Effect that Uses the Display Capture " on page 88, the 
image created by the graphic circuitry is put into VRAM using the capture feature, and then the image 
is displayed with the mode set to VRAM Display. When the image is captured, a motion blur effect is 
achieved by blending with the display-use VRAM. 
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Figure 5-7 : Example of the Motion Blur Effect that Uses the Display Capture 
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5.4.4.3 Main Memory Display Mode 

This mode enables the display of bitmap data held in main memory. When the DISPCNT register is set to 
main memory display mode, the data held in the main memory display FIFO is transferred to the LCD 
module at the beginning of the next display. A data request is sent to DMA for every data transfer. 

There is a four-layer FIFO between the main memory display FIFO register and the LCD module, and the 
LCD module takes four words at a time. For this reason, you should write four layers of data at a time to the 
main memory display FIFO register. 

To be more specific, after setting the DMA transfer bit width to 32 bits and the word count to 4, set the DMA 
startup mode to main memory display mode. For this mode, be sure to set the DMA source address to the 
main memory region. 

Table 5-7 shows the DMA configuration when using the main memory display mode. 

Table 5-7 : DMA Configuration when Using the Main Memory Display Mode 


Setting 

Value 

Source Address 

Main memory 

Transfer Bit Width 

32 bits 

Word Count 

4 


For details about the DMA configuration, see "8 DMA" on page 297 . 

Data from main memory is displayed using a system other than the 2D and 3D circuitry, so when the mode 
is set to main memory display, images can be created by the graphics circuitry and captured to VRAM at 
the same time that images are being displayed. (See " Figure 5-1 : Display System Block Diagram " on page 
72.) 


Main Memory Display FIFO Register 

Name: DISP MMEM FIFO Address: 0x04000068 Attribute: R/W Initial value: 0x00000000 


31 30 


26 25 24 23 


21 20 


16 


15 14 


10 9 8 7 


5 4 



BLUE 

GREEN 

RED 


BLUE 

GREEN 

RED 

ODD 

EVEN 


" Figure 5-8 : LCD Pixel EVEN/ODD Map of the Main Memory Display FIFO Register " on page 90 shows 
the LCD pixel EVEN/ODD map of the main memory display FIFO register. 
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Figure 5-8 : LCD Pixel EVEN/ODD Map of the Main Memory Display FIFO Register 
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5.5 Display Capture 

This feature enables 2D and 3D graphics and image output from VRAM and main memory to be read into 
VRAM. 

Only the image output on the Display Output A side (the 2D graphics engine) can be captured. 

It also enables images from two sources to be blended, and then captured. 

DISPCAPCNT: Display Capture Control Register 

Name: DISPCAPCNT Address: 0x04000064 Attribute: R/W Initial value: 0x00000000 



• E[d31] : Display Capture Enable Flag 

When the flag is set to 1, one screen of data is captured from the next 0 line, and then the flag is set to 0. 


0 

Disable 

1 

Enable 


• MOD[d30-d29] : Capture Mode 


00 

Capture data from source A 

01 

Capture data from source B 

10 

Capture the result of blending data 
from sources A and B 

11 
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• COFS[d27-d26] : Read Address Offset for Capture Data Source VRAM 

Invalid in VRAM dispiay mode. 

If the offset exceeds 0x20000 during reading, the reading continues after wrapping to address 
0x00000. 


00 

0x00000 

01 

0x08000 

10 

0x10000 

11 

0x18000 


• SRC[d25-d24] : Capture Data Source Seiection 

B 


0 

VRAM 

1 

Main Memory 


A 


0 

Graphics dispiay screen (after 3D/2D biending) 

1 

3D screen 


• WSIZE[d21-d20] : Capture Size 

Specifies the size when writing the capture data. With RAM captures, one iine is aiways read as a 
256-dot image, so you cannot biend and then capture (see Capture mode above) when the setting is 
128x128 dots. 


00 

128x128 dots (0x08000 bytes) 

01 

256x64 dots (0x08000 bytes) 

10 

256x128 dots (0x10000 bytes) 

11 

256x192 dots (0x18000 bytes) 


• WOFS[d19-d18] : Address Offset for Capture Data Write 

This can specify the offset vaiue for the address where data is written in the specified VRAM. If the 
offset exceeds 0x20000 during writing, the writing continues after wrapping to address 0x00000. 


00 

0x00000 

01 

0x08000 

10 

0x10000 

11 

0x18000 
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• DEST[d17-d16] : Capture Data Write Destination VRAM Seiection 

The write destination VRAM must be aiiocated to the LCDC. 


00 

VRAM-A 

01 

VRAM-B 

10 

VRAM-C 

11 

VRAM-D 


• EVB[d12-d08], EVA[d04-d00] : Biending Factors 

Sets the biending factors for capture sources A and B. See beiow for the caicuiation method. 

In VRAM dispiay mode, you can set the same VRAM biock for dispiay VRAM and for writing the 
captured image data. 

Capture Data Format 


15 14_10 9 8 I 7_5 4_0 


A 

BLUE 

GREEN 

RED 

a 

Pixel Coior Data 


Aithough 3D graphics are output in R:G:B=6:6:6 coior, because capture occurs in R:G:B=5:5:5 coior 
(empioying the upper 5 bits), the image gradient becomes a iittie coarse. 

Figure 5-9 shows the LCD pixei map of the capture data when the capture size is 256 x 192 dots. 

Figure 5-9 : LCD Pixel Map of the Capture Data (When the Capture Size is 256 x 192 Dots) 
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• How to calculate data to write 

1. For data captured from source A: 

CAP = Ca 

Capture source A's alpha value is used for the alpha value. 

2. For data captured from source B: 

CAP = Cb 

Capture source B's alpha value is used for the aipha vaiue 

3. For capturing data biended from sources A and B: 

^^^_{CaxAaxEVA)+{CbxAbxEVB) 

0/1 j —- 

16 

The aipha vaiue is 1 when EVA is non-zero and capture source A's aipha vaiue is 1, or when EVB 
is non-zero and capture source B's aipha vaiue is 1. In aii other circumstances, the aipha vaiue is 
0 . 

CAP: The coior to write (caicuiation resuits are rounded to the nearest integer) 

Ca: A's capture source data coior, EVA: Biending factor for A 
Cb: B's capture source data coior, EVB: Biending factor for B 
Aa: A's aipha vaiue: A's capture source aipha vaiue. 

Determined as shown beiow. 


Capture Source A 
Selection 

3D Screen Alpha 
Value 

Aa 

0 

- 

1 

1 

0 

0 


1 -31 

1 


Ab: aipha vaiue of B: aipha vaiue of B's capture source 

Note: When a confiict occurs between access to the dispiay circuit VRAM and access to VRAM from the 
CPU, the dispiay circuit VRAM access takes precedence. 

Because the dot ciock of the LCD controiier is 1/6 of a cycie of the image processing dock and the 
system ciock, the timing for the LCD controiier to access the VRAM is once every six cycies. 

If the VRAM of the capture is being dispiayed whiie dispiay capturing, the frequency at which the 
dispiay circuit accesses the VRAM is doubied, and the VRAM is accessed with a timing of once 
every three cycies. 

With this timing, when simuitaneousiy accessing from the CPU, the CPU access must wait one 
cycie. 
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5.6 Master Brightness 

The brightness up/down process for Image Output A is bandied by the configuration of the 
MASTER_BRIGHT register, whiie the brightness up/down process for Image Output B is bandied by the 
configuration of the DB_MASTER_BRIGHT register. 

MASTER_BRIGHT: Master Brightness Up/Down Register 

Name: MASTER BRIGHT Address: 0x0400006C Attribute: R/W Initial value: 0x0000 


15 14 

4 0 

E_MOD 










E_VALUE 

Mode 










Factor 


DB_MASTER_BRIGHT: Master Brightness Up/Down B Register 

Name: DB MASTER BRIGHT Address: 0x0400106C Attribute: R/W Initial value: 0x0000 


15 14 

4 0 

E_MOD 










E_VALUE 

Mode 










Factor 


The MASTER BRIGHT and DB MASTER BRIGHT registers share identicai configuration detaiis. 
• E MOD [d15-d14] : Mode 

Sets the mode for processing brightness up/down. 


Setting 

Process 

00 

No change in brightness 

01 

Increase brightness 

10 

Decrease brightness 

11 

Setting prohibited 


• E VALUE [d04-d00] : Factor 

Sets the factors as caicuiated beiow. 

1. Brightness up computation 

Rout = Rin + (63 - Rin) x (E_VALUE/16) 

Gout = Gin + (63 - Gin) x (E_VALUE/16) 

Bout = Bin + (63 - Bin) x (E_VALUE/16) 

2. Brightness down computation 
Rout = Rin - Rin x (E_VALUE/16) 

Gout = Gin - Gin x (E_VALUE/16) 

Bout = Bin - Bin x (E_VALUE/16) 

The resuit of the Brightness Up and Down computation (Rout, Gout, and Bout) is rounded to the 
nearest integer. 
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6 2D Graphics 

TWL’s 2D graphics engines are unchanged from NiTRO except for circuit revisions (bug fixes) to the BG 
window features. For detaiis on the changes, refer to " 6.6 Windows " on page 166. 

TWL has two 2D graphics engines: 2D Graphics Engine A and 2D Graphics Engine B. 2D Graphics Engine 
A can use 3D Graphics BG and iarge-screen 256-coior Bitmap BG, but 2D Graphics Engine B cannot, in 
the foiiowing sections, 2D Graphics Engine A is sometimes referred to as 2D_A and 2D Graphics Engine B 
as 2D_B. Where register names differ for 2D Graphics Engine A and 2D Graphics Engine B, the register 
name for 2D Graphics Engine B is given inside square brackets [ ]. 

6.1 Controlling the 2D Display 

The dispiay for each 2D graphics feature can be controiied and turned on or off independentiy. Controi 
register settings differ for 2D Graphics Engine A and 2D Graphics Engine B. 


DISPCNT: Display Control Register (2D Graphics Engine A) 

Name: DISPCNT Address: 0x04000000 Attribute: R/W initiai Vaiue: 0x00000000 



• [d15-d13] : Window Dispiay Enabie Fiag 

See " 6.6 Windows " on page 166 to read about the window features. 
• OW [d15] : OBJ Window Dispiay Enabie Fiag 


0 

Disable display 

1 

Enable display 


To dispiay the OBJ Window requires enabiing both the OBJ Window Dispiay Enabie Fiag and the OBJ 
Dispiay Enabie Fiag. 

• W1 [d14] : Window 1 Dispiay Enabie Fiag 


0 

Disable display 

1 

Enable display 
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• WO [d13] : Window 0 Display Enable Flag 


0 

Disable display 

1 

Enable display 


• [d12-d08] : Display Selection Flag 

• O [d12] : OBJ Display Enable Flag 


0 

Disable display 

1 

Enable display 

B3 [d11] : 

BG3 Display Enable Flag 

0 

Disable display 

1 

Enable display 

B2 [d10] : 

BG2 Display Enable Flag 

0 

Disable display 

1 

Enable display 


• B1 [d09] : BG1 Display Enable Flag 


0 

Disable display 

1 

Enable display 


• BO [d08] : BGO Display Enable Flag 


0 

Disable display 

1 

Enable display 


Note: The [d12-d08] Display Selection Flags are applied at different times depending on whether display 
is enabled or disabled. When one of these flags is toggled from 1 to 0, display is disabled 
immediately. When one of these flags is toggled from 0 to 1, display is enabled beginning from the 
start of the line three lines later. 
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DB_DISPCNT: Display Control Register 1 (2D Graphics Engine B) 

Name: DB DISPCNT Address: 0x04001000 Attribute: R/W Initial Value: 0x00000000 



• [d15-d13] : Window Display Enable Flag 

See " 6.6 Windows " on page 166 to read about the window features. 
• OW [d15] : OBJ Window Dispiay Enabie Fiag 


0 

Disable display 

1 

Enable display 


To dispiay the OBJ Window requires enabiing both the OBJ Window Dispiay Enabie Fiag and the OBJ 
Dispiay Enabie Fiag. 

• W1 [d14] : Window 1 Dispiay Enabie Fiag 


0 

Disable display 

1 

Enable display 


• WO [d13] : Window 0 Dispiay Enabie Fiag 


0 

Disable display 

1 

Enable display 


• [d12-d08] : Dispiay Seiection Fiag 

• O [d12] : OBJ Dispiay Enabie Fiag 


0 

Disable display 

1 

Enable display 


• B3 [dll] : BG3 Dispiay Enabie Fiag 


0 

Disable display 

1 

Enable display 


• B2 [d10] : BG2 Dispiay Enabie Fiag 


0 

Disable display 

1 

Enable display 
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• B1 [d09] : BG1 Display Enable Flag 


0 

Disable display 

1 

Enable display 


• BO [d08] : BGO Display Enable Flag 


0 

Disable display 

1 

Enable display 


Note: The [d12-d08] Display Selection Fiags are appiied at different times depending on whether dispiay 
is enabied or disabied. When one of these fiags is toggied from 1 to 0, dispiay is disabied 
immediateiy. When one of these fiags is toggied from 0 to 1, dispiay is enabied beginning from the 
start of the iine three iines iater. 
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6.2 BG 

6.2.1 BG Mode 

The BG modes that can be set for 2D Graphics Engine A and 2D Graphics Engine B are different. 

6.2.1.1 2D Graphics Engine A 

With 2D Graphics Engine A, BGO can be dispiayed as either 2D or 3D. In addition, Large-Screen 
256-Coior Bitmap BG can be seiected as the BG type for BG2. 

DiSPCNT: Dispiay Controi Register (2D Graphics Engine A) 

Name: DISPCNT Address: 0x04000000 Attribute: R/W Initial Value: 0x00000000 



• [d02-d00] : BG Mode 

These bits set the BG mode number. The BG mode selects the BG types that can be used. See Table 
6-1 for a list of BG modes for 2D Graphics Engine A. 

The DISPCNT register can be used to select either Text BG or 3D BG as the BG type for BGO. See V 
3D Graphics" on page 177 for details on 3D BG display. 


Table 6-1: List of BG Modes (2D Graphics Engine A) 


BG Mode Number 

BGO 

BG1 

BG2 

BG3 

0 

Text BG/3D BG 

Text BG 

Text BG 

Text BG 

1 

Text BG/3D BG 

Text BG 

Text BG 

Affine BG 

2 

Text BG/3D BG 

Text BG 

Affine BG 

Affine BG 

3 

Text BG/3D BG 

Text BG 

Text BG 

Affine Extended BG 

4 

Text BG/3D BG 

Text BG 

Affine BG 

Affine Extended BG 

5 

Text BG/3D BG 

Text BG 

Affine Extended BG 

Affine Extended BG 

6 

3D BG 

— 

Large-Screen 
256-Color Bitmap BG 

— 

7 

Prohibited Setting 
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6.2.1.2 2D Graphics Engine B 

DB_DiSPCNT: Dispiay Controi Register 1 (2D Graphics Engine B) 

Name: DB DISPCNT Address: 0x04001000 Attribute: R/W Initial Value: 0x00000000 



• [d02-d00] : BG Mode 

These bits set the BG mode number. The BG mode selects the BG types that can be used. See Table 
6-2 for a list of BG modes for 2D Graphics Engine B. 

Note: Uniike 2D Graphics Engine A, Large-screen 256-Coior Bitmap BG cannot be set as the BG 
type for BG2. Furthermore, 3D BG dispiay cannot be set as the BG type for BGO. 


Table 6-2 : List of BG Modes i 

(2D Graphics Engine B) 

BG Mode Number 

BGO 

BG1 

BG2 

BG3 

0 

Text BG 

Text BG 

Text BG 

Text BG 

1 

Text BG 

Text BG 

Text BG 

Affine BG 

2 

Text BG 

Text BG 

Affine BG 

Affine BG 

3 

Text BG 

Text BG 

Text BG 

Affine Extended BG 

4 

Text BG 

Text BG 

Affine BG 

Affine Extended BG 

5 

Text BG 

Text BG 

Affine Extended BG 

Affine Extended BG 

6 

Prohibited Setting 

7 

Prohibited Setting 
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6.2.1.3 Basic Features for Each Type of BG 

Each BG type has its own special features as described in Table 6-3. 


Table 6-3 : Basic Features of BG Types 


BG Type 

Features 

3D BG 

This type can display Images generated by the 3D graphics engine. 

It can be displayed with other BG screens according to alpha-blending and priority settings. 
2D Graphics Engine B cannot use this type. 

Text BG 

This type is a character format BG. 

Text BG is the only BG type that can handle characters defined in 16 colors and control 
VRAM consumption, but it cannot accommodate affine transformations. 

Affine BG 

This type is the character format BG that can accommodate affine transformations. 

It cannot perform character-unit processes (such as HV Flips). 

Affine Extended BG 

Three types are available: 

• Character BG that can use 256 colors x 16 palettes 

• 256-Color Bitmap BG 

• Direct Color Bitmap BG that can specify color directly 

Large-Screen 
256-Color Bitmap BG 

This type is the Large-Screen Bitmap BG. 

Because one screen makes full use of the maximum capacity of BG-VRAM (512 KB), it 
cannot be used together with other BGs. Flowever, it can be used together with a 3D screen. 
2D Graphics Engine B cannot use this type. 
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6.2.1.4 Specifications for Different BG Types 

The specifications for the different types of BG are shown in Tabie 6-4. 


Table 6-4 : Specifications for BG Types 


Category 

Character BG 

Bitmap BG 

BG Type 

Specs 

3DBG 

Text BG 

Affine BG 

Affine Extended BG 

Large- 
Screen 256- 
Color 
Bitmap BG 

256-Color x 
16 Palettes 

256-Color 

Direct 

Color 

Screen Size 

256x192 

256x256 

512x256 

256x512 

512x512 

128x128 

256x256 

512x512 

1,024x1,024 

128x128 

256x256 

512x512 

1,024x1,024 

128x128 

256x256 

512x256 

512x512 

128x128 

256x256 

512x256 

512x512 

512x1,024 

1,024x512 

Specifiable 
Character Count 

— 

1,024 

256 

1,024 

— 

— 

— 

Number of 
Colors/Palettes 

262,144 

16/16 

256/1 

256/16 

256/1 

256/16 

256/1 

32,768 

256/1 

Affine 



X 

X 

X 

X 

X 

HV Flip 


X 


X 




H Scroll 

X 

X 

X 

X 

X 

X 

X 

V Scroll 


X 

X 

X 

X 

X 

X 

Mosaic 


X 

X 

X 

X 

X 

X 

Fade-in/Fade-out 

X 

X 

X 

X 

X 

X 

X 

Alpha Blending 

X 

X 

X 

X 

X 

X 

X 

Priority 

X 

X 

X 

X 

X 

X 

X 


Note 1 : 2D Graphics Engine B cannot set 3D BG and Large-Screen 256-Coior Bitmap BG as BG types. 

Note 2: Because the aiiocation of BG-VRAM to 2D Graphics Engine B is iimited, the foiiowing settings can¬ 
not be used: 

• 256-Coior Bitmap: 512x512 

• Direct Coior Bitmap: 512x256 and 512x512 
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6.2.2 BG Control 

There are four BG control registers that correspond to the number of BG screens. With 2D Graphics 
Engine A, the BG screens are controlled with the BGOCNT, BG1CNT, BG2CNT, and BG3CNT 
registers.With 2D Graphics Engine B, the BG screens are controlled with the DB_BG0CNT, DB_BG1CNT, 
DB_BG2CNT, and DB_BG3CNT registers. 

Note: 2D Graphics Engine A and 2D Graphics Engine B use different register names as well as different 
methods to calculate base address values for BG screen data and BG character data. 

BGx(x=0,1) Control Register 

Name Address Attribute Initial Value 

(2D_A) BGxCNT(x=0, 1) 0x04000008,0x0400000A R/W 0x0000 

(2D B) DB BGxCNT(x=0, 1) 0x04001008, 0x04001 OOA Sw 0x0000 



• [d15-d14] : Screen Size 


Screen Size 
Settings 

Text BG 

Screen Size 

Screen Data Size 

00 

256x256 

2 KB 

01 

512x256 

4 KB 

10 

256x512 

4 KB 

11 

512x512 

8 KB 


• [d13] : BG Extended Palette Slot Selection 

This bit specifies the Extended Palette Slot Number used when BG extended palettes are enabled. 
The settings differ for BGO and BG1. Extended palettes are enabled/disabled with the DISPCNT 
[DB_DISPCNT] register. See " 3.2.1 VRAM " on page 28 for more information on the palette slot 
memory map. 

1. BGOCNT [DB_BG0CNT] 
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• SB4-SB0 [d12-d08] : Screen Base Block 

These bits specify (in 2KB units) the starting biock in VRAM where screen data is stored. When screen 
data is actuaiiy referenced, the starting address is caicuiated as foiiows. 

2D Graphics Engine A 

The starting address is the sum of the DISPCNT register's screen base offset vaiue with a 64KB offset 
and the screen base biock with a 2KB offset. 

(screen base offset x 0x10000) + (screen base biock x 0x800) 

2D Graphics Engine B 

The starting address is the screen base biock with a 2KB offset. 

(screen base biock x 0x800) 

• CM [d07] : Coior Mode 

This bit specifies whether the screen data references BG character data in 16-coior or 256-coior 
format. 


0 

16-color mode 

1 

256-color mode 


• [d06] : Mosaic 

This bit controis whether the mosaic process for BG is on or off. Set the mosaic size with the MOSAIC 
[DB MOSAIC] register. 

• CB3-CB0 [d05-d02] : Character Base Biock 

These bits specify (in 16KB units) the starting biock in VRAM for storing character data. When 
character data is actuaiiy referenced, the starting address is caicuiated as foiiows. 

2D Graphics Engine A 

The starting address is the sum of the DISPCNT register's character base offset vaiue with a 64KB 
offset and the character base biock with a 16KB offset. 

(character base offset x 0x10000) + (character base biock x 0x4000) 

2D Graphics Engine B 

The starting address is the character base biock with a 16KB offset. 

(character base biock x 0x4000) 

• [dOI-dOO] : Priority 

The defauit order of priority among the BG screens is BGO > BG1 > BG2 > BG3 (when priority settings 
are the same). However, this order can be changed. Priorities of 0 (highest) to 3 (iowest) can be set. 
Be carefui of the pixei specifications to which coior speciai effects are appiied when changing BG 
priorities. 


TWL-06-0017-001-D 
Released: February 16, 2009 


106 


© 2008-2009 Nintendo 
CONFIDENTIAL 




TWL Programming Manual 


BGx(x=2, 3) Control Register 

Name Address Attribute Initial Value 

(2D_A) BGxCNT(x=2,3) 0x0400000C, 0x0400000E R/W 0x0000 

(2D_B) DB_BGxCNT(x=2, 3) 0x04001 OOC, 0x04001 OOE R/W 0x0000 



The bit definitions for Coior Mode, Mosaic, Character Base Biock, and Priority are the same as for the BGx 
(x=0, 1) Controi Registers described above. BG2 uses Extended Paiette Siot 2 and BG3 uses Extended 
Paiette Siot 3 when extended paiettes are enabied. The extended paiette numbers used by BG2 and BG3 
cannot be changed. The extended paiettes can be enabied/disabied with the DISPCNT [DB DISPCNT] 
register. 

• [d15-d14] : Screen Size 

The screen sizes that can be configured depend on the BG type and are described in Tabie 6-5 and 

" Tabie 6-6 : Screen Sizes (2D Graphics Engine B) " on page 108. 

Note: 2D Graphics Engine A and 2D Graphics Engine B accommodate different combinations of 
screen sizes and BG types that can be configured. 2D Graphics Engine B cannot set Large- 
Screen 256-Coior Bitmap BG as the BG type. In addition, because a maximum of 128 KB of 
BG-VRAM can be aiiocated to 2D Graphics Engine B, screen sizes exceeding 128 KB are pro¬ 
hibited. 


Table 6-5 : Screen Sizes (2D Graphics Engine A) 


Screen Size 
Settings 

Text BG 

Affine BG 

Affine Extended BG 

Large-Screen 
256-Color 
Bitmap BG 

256-Color x 16- 
Palette 
Character BG 

256-Color 
Bitmap BG 

Direct-Color 
Bitmap BG 

00 

256x256 
(2 KB) 

128x128 
(256 bytes) 

128x128 
(512 bytes) 

128x128 
<16 KB > 

128x128 
<32 KB > 

512x1024 
<512 KB > 

01 

512x256 
(4 KB) 

256x256 
(1 KB) 

256x256 
(2 KB) 

256x256 
<64 KB > 

256x256 
<128 KB > 

1024x512 
<512 KB > 

10 

256x512 
(4 KB) 

512x512 
(4 KB) 

512x512 
(8 KB) 

512x256 
<128 KB > 

512x256 
<256 KB > 

— 

11 

512x512 
(8 KB) 

1024x1024 
(16 KB) 

1024x1024 
(32 KB) 

512x512 
<256 KB > 

512x512 
<512 KB > 

— 


Note: The screen size is enciosed in parentheses () and the bitmap data size in angie brackets <>. 
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Table 6-6 : Screen Sizes (2D Graphics Engine B) 


Screen Size 
Settings 

Text BG 

Affine BG 

Affine Extended BG 

256-Color x 16- 
Palette 
Character BG 

256-Color 
Bitmap BG 

Direct-Color 
Bitmap BG 

00 

256x256 
(2 KB) 

128x128 
(256 bytes) 

128x128 
(512 bytes) 

128x128 
<16 KB > 

128x128 
<32 KB > 

01 

512x256 
(4 KB) 

256x256 
(1 KB) 

256x256 
(2 KB) 

256x256 
<64 KB > 

256x256 
<128 KB > 

10 

256x512 
(4 KB) 

512x512 
(4 KB) 

512x512 
(8 KB) 

512x256 
<128 KB> 

Prohibited 

Setting 

11 

512x512 
(8 KB) 

1024x1024 
(16 KB) 

1024x1024 
(32 KB) 

Prohibited 

Setting 

Prohibited 

Setting 


Note: The screen size is enciosed in parentheses () and the bitmap data size in angie brackets <>. 

• [d13] : Out-of-Area Processing 

This bit seiects either to make out-of-area regions transparent or to wrap around and dispiay when the 
BG screen does not iie entireiy within the dispiay screen because of affine transformations. 


0 

Transparent display 

1 

Wraparound display 


The difference between the two Out-of-Area processing methods is shown in Figure 6-1. 
Figure 6-1 : Out-of-Area Processing Method Differences 

Transparent Display of Out-of-Area Part Wraparound Display of Out-of-Area Part 




• SB4-SB0 [d12-d08] : Screen Base Block 

Calculation of the base address for the screen base biock differs according to the BG mode. 

1. Character BG 

These bits specify (in 2KB units) the starting biock in VRAM where screen data is stored. When 
screen data is actuaiiy referenced, the starting address is caicuiated as foiiows. 
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2D Graphics Engine A 

The starting address is the sum of the DISPCNT register's screen base offset vaiue with a 64KB 
offset and the vaiue of the screen base biock with a 2KB offset. 

(screen base offset x 0x10000) + (screen base biock x 0x800) 

2D Graphics Engine B 

The starting address is the screen base biock with a 2KB offset. 

(screen base biock x 0x800) 

2. 256-Coior Bitmap BG and Direct Coior Bitmap BG 

These bits specify (in 16KB units) the offset address in BG-VRAM where the bitmap data is stored. 
Because there is no reiation to the screen base offset vaiue in the DISPCNT register, the same 
caicuiation for the BG bitmap data starting address is used for both 2D Graphics Engine A and 2D 
Graphics Engine B. 

2D Graphics Engine A and 2D Graphics Engine B 

(screen base biock x 0x4000) 

3. Large-Screen 256-Coior Bitmap BG 

The screen base biock vaiue is invaiid for 2D Graphics Engine A. 

The BG mode cannot be set to iarge-screen 256-coior bitmap BG for 2D Graphics Engine B. 

• [d07, d02] : Affine Extended BG Type Seiection (oniy with Affine Extended BG) 


CM 

CBO 

Affine Extended BG Type 

0 

(See note) 

256-color x 16-palette Character BG 

1 

0 

256-color bitmap BG 

1 

1 

Direct-color bitmap BG 


Note: When CM = 0, a unique 256-coior x 16-paiette Character BG is used and CB3-CB0 are ban¬ 
died as normai character base biocks. 
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6.2.2.1 Screen Sizes and Display Screens 

6.2.2.1.1 TextBG 

Text BG screen sizes are shown in Figure 6-2. 

Figure 6-2 : Text BG Screen Size 
Screen Size 256 x 256 Screen Size 512 x 256 


Screen 0 Screen 0 
(256 x 256) (256 x 256) 

Display 

- Screen- 

(256 X 192) 

Screen 0 | Screen 0 

(256 x 256) j (256 x 256) 


Screen Size 256 x 512 Screen Size 512 x 512 



Screen 0 Screen 1 Screen 0 
(256 x 256) I (256 x 256) (256 x 256) 


Screen 0 
(256 X 256) 

Screen 1 
(256 x 256) 


Display 
Screen 
(256 X 192) 




1 Screen 0 
(256 x 256) 

Screen 1 1 

(256 x 256) 
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6.2.2.1.2 Affine BG 


Affine BG screen sizes are shown in Figure 6-3. 

Figure 6-3 : Affine BG Screen Size 


Screen Size 128 x 128 


Screen Size 256 x 256 



Screen 0 
or Transparent 
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6.2.3 Character BG 

For character BG, BG screen composition eiements are treated as characters of 8 x 8 dots (8x8-dot). 
Accordingiy, character data is required to dispiay the BG. In addition, character index data for each 8x8-dot 
unit is required; this character index data is caiied screen data. 

Note: 2D Graphics Engine B differs from 2D Graphics Engine A in that there are no settings for the BG 
screen base offset and BG character base offset. 

Display Control Register 

Name: DISPCNT Address: 0x04000000 Attribute: R/W Initial Value: 0x00000000 



• [d29-d27] : BG Screen Base Offset 

These bits offset (in 64KB units) the base address of the screen data set with the BG Controi Register. 
Accordingiy, the base address of the BG screen data is caicuiated as foiiows: 

The vaiue set in the BG Controi Register + (BG screen base offset x 0x10000) 

An arbitrary base address can be specified from a maximum 512 KB of BG-VRAM space. 

• [d26-d24] : BG Character Base Offset 

These bits offset (in 64KB units) the base address of the screen data set with the BG Controi Register. 
Accordingiy, the base address of the BG character data is caicuiated as foiiows: 

The vaiue set in the BG Controi Register + (BG character base offset x 0x10000) 

An arbitrary base address can be specified from a maximum 512 KB of BG-VRAM space. 
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6.2.3.1 VRAM Maps of BG Data 

Character BG requires both BG screen data and BG character data. Store both the BG screen data and 
the BG character data in VRAM that was aiiocated to BG-VRAM by the RAM Bank Controi Register. BG- 
VRAM can be assigned up to a maximum of 512 KB with 2D Graphics Engine A and up to a maximum of 
128 KB with 2D Graphics Engine B. 

1. BG Character Data 

With 2D Graphics Engine A, the starting address for referencing BG character data can be set by 
specifying the DISPCNT register's character base offset and the BG Controi register's character base 
biock. With 2D Graphics Engine B, there is no setting for character base offset. The VRAM offset for 
BG character data is shown in Figure 6-4. 

The voiume of data depends on the amount of registered character data and the format (Coior Mode: 
256 or 16 coiors). 

Figure 6-4 : VRAM Offset for BG Character Data 


Base Offset in VRAM 


BG Character Data 
Base Blocks 


0x80000 +40000h 



Base Offset 7 

+3C00QK' 

Base Block 15 

0x70000 

+380<i'oh 

Base Block 14 


Base Offset 6 

+3'i000h 

Base Block 13 

0x60000 

/+30000h 

Base Block 12 


Base Offset 5 

/ +2C00ph' 

Base Block 11 

0x50000 

+ 2 . 8 dboh 

Base Block 10 


Base Offset 4 

,-•<240000 

Base Block 9 

0x40000 

+200000 

Base Block 8 


Base Offset 3 

+1C00<5fr 

Base Block 7 

0x30000 

,xd8000h 

Base Block 6 


Base Offset 2 

+140000 

Base Block 5 

0x20000 

+100000 

Base Block 4 


Base Offset 1 

....+eodoh 

Base Block 3 

0x10000 

..+80000 

Base Block 2 


Base Offset 0 

+40000 

Base Block 1 

0x00000 

+00 

Base Block 0 


Note: For 2D Graphics Engine A, the maximum amount of VRAM that can be used for BG character 
data is 256 KB because the DISPCNT register's base offset cannot be set for each BG screen. 

For 2D Graphics Engine B, the maximum amount of VRAM that can be used for BG character 
data is 128 KB because there are iimitations on the size of BG-VRAM that can be aiiocated. 
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2. BG Screen Data 

For 2D Graphics Engine A, the starting address for referencing BG screen data can be set by 
specifying the DISPCNT register's screen base offset and the BG Controi register's screen base biock. 
With 2D Graphics Engine B, there is no setting for the screen base offset. The VRAM offset for BG 
screen data is shown in Figure 6-5. 

The voiume of data depends on the BG type (Text BG or Affine BG) and the screen size. 

Figure 6-5 : VRAM Offset for BG Screen Data 


Base Offsets in VRAM 


BG Screen Data 
Base Blocks 


0x80000 +10000h 


0x70000 

Base Offset 7 

+F800h''’ 

Base Block 31 

+C8,0Oh 


0x60000 

Base Offset 6 

+G 600 h 

Base Block 24 

0x50000 

Base Offset 5 

+4800h 

Base Block 23 

/ +8800h 


0x40000 

Base Offset 4 

/ +8000h 

Base Block 16 

0x30000 

Base Offset 3 

/ +7800h 

Base Block 15 

+4800h 


0x20000 

Base Offset 2 

/ +4000h 

Base Block 8 

0x10000 

Base Offset 1 

i +3800h 

Base Block 7 

+800h 


0x00000 

Base Offset 0 

+0h 

Base Block 0 


Note: For 2D Graphics Engine A, the maximum amount of VRAM that can be used for BG screen 
data is 64 KB because the DISPCNT register's base offset cannot be set for each BG screen. 

With 2D Graphics Engine B, the maximum amount of VRAM that can be used for BG screen 
data is 64 KB. 
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6.2.3.2 Text BG 
6.2.3.2.1 Screen Data Format 

Store the BG screen data starting from the starting address of the BG screen base biock specified by the 
BG Controi Register. BG screen data for Text BG screens is configured using the foiiowing format: 


15 


12 


11 


Text BG Screen Data 

10 9 8 I 7 






VF 

HF 











Color Palette 

Flip 

Character Name 


• [d15-d12] : Coior Paiette 

Paiettes appiied to characters are specified in the range of 0-15. The Coior Paiette specification is 
enabied with 256 coiors x 16 paiettes or 16 coiors x 16 paiettes, but it is disabied with 256 coiors x 1 
paiette. 

• [dll-dIO] : Fiip 

• VF: Verticai Fiip Fiag FIF: Florizontai Fiip Fiag 


0 

Do not flip 

1 

Flip 


• [d09-d00] : Character Name 

These bits specify the character number of the character that serves as the origin of the starting 
address for the character base biock specified by the BG Controi Register. 
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6.2.3.2.2 Screen Data Address Mapping 
1. 256x256-Dot Screen Size 

Figure 6-6 shows the address map for screen data with a 256x256-dot screen size. 

Figure 6-6 : 256x256-Dot Address Mapping (Text BG) 



□ Display Region 


2. 256x512-Dot Screen Size 

Figure 6-7 shows the address map for screen data with a 256x512-dot screen size. 

Figure 6-7 : 256x512-Dot Address Mapping (Text BG) 



□ Display Region 
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3. 512x256-Dot Screen Size 

Figure 6-8 shows the address map for screen data with a 512x256-dot screen size. 


Figure 6-8 : 512x256-Dot Address Mapping (Text BG) 



n Display Region 


4. 512x512-Dot Screen Size 

Figure 6-9 shows the address map for screen data with a 512x512-dot screen size. 


Figure 6-9 : 512x512-Dot Address Mapping (Text BG) 



□ Display Region 
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6.2.3.2.3 Character Data Formats 

The character data formats for Text BG 16-color mode and Text BG 256-color mode are shown below. The 
Character Display table shows the case when an 8x8-dot character is defined. 

6.2.3.2.3.1 16-Color Mode 

The character data format for 16-coior mode, correspondence between character dispiay and pixei data, 
and address mapping (Figure 6-10) are shown beiow. 


15 


16-Color Mode Character Data Format 

12 11 8 I 7 4 3 


P3 

P2 

PI 

PO 

4 pixels worth of data (4 bits/pixel) 


Character Display 


PO 

PI 

P2 

P3 






























Figure 6-10 : Character Data Address Mapping (Text BG 16-Color Mode) 
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6.2.3.2.3.2 256-Color Mode 

The character data format for 256-color mode, correspondence between character display and pixel data, 
and address mapping (Figure 6-11) are shown beiow. 


256-Color Mode Character Data Format 


12 11 


PI 


8 7 


2 pixels worth of data (8 bits/pixel) 


Character Display 


4 3 


PO 


PO 

PI 
































Figure 6-11 : Character Data Address Mapping (Text BG 256-Color Mode) 


8 bits of data for each dot 
(specifies 1 of 256 colors) 


do / do / do / do / dO / dO / d( 
d1 / d1 / d1 / d1 / d1 / d1 / d1 
d2 / d2 / d2 / d2 7 d2 / d2 / d2 


Byte 0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 

61 

62 

63 
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6.2.3.3 Affine BG 

This character format BG type can be rotated and scaled. 

Note: Affine BG can be set only with BG2 and BG3. The color mode for Affine BG screens is fixed to 
256-color mode. Consequently, the BG Control Register's color-mode setting is disabled. 
Furthermore, horizontal and vertical flips cannot be performed on Affine BG. 

6.2.3.3.1 Screen Data Format 

Store the BG screen data starting from the starting address of the BG screen base block specified by the 
BG Control register. 

BG screen data for Affine BG screens is configured using the following format: 

Affine BG Screen Data 


7 







0 









Character Name 


• [d07-d00] : Character Name 

These bits specify the character number of the character that serves as the origin of the starting 
address for the character base block specified by the BG Control Register. 
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6.2.3.3.2 Screen Data Address Mapping 
1. 128X128-Dot Screen Size 

Figure 6-12 shows the address map for screen data with a 128x128-dot screen size. 

Figure 6-12 :128X128-Dot Address Mapping (Affine BG) 



2. 256x256-Dot Screen Size 

Figure 6-13 shows the address map for screen data with a 256x256-dot screen size. 

Figure 6-13 : 256x256-Dot Address Mapping (Affine BG) 

L 256 Dots J 

r (32 Blocks) 1 


256 Dots 
(32 Blocks) 


OOOh 

001 h 

CM 

O 

O 



01 Fh 

020h 

021 h 

CM 

CM 

O 



03Fh 







2E0h 

2E1h 

CM 

LU 

CM 



2FFh 







3E0h 

3E1h 

3E2h 



3FFh 


192 Dots 
(24 Blocks) 


□ Display Region 
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3. 512x512-Dot Screen Size 

Figure 6-14 shows the address map for screen data with a 512x512-dot screen size. 

Figure 6-14 : 512x512-Dot Address Mapping (Affine BG) 



□ Display Region 
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4. 1024x1024-Dot Screen Size 

Figure 6-15 shows the address map for screen data with a 1024x1024-dot screen size. 

Figure 6-15 :1024x1024-Dot Address Mapping (Affine BG) 

i 1024 Dots 



n Display Region 
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6.2.3.3.3 Character Data Format 

The character data format for Affine BG screens is shown beiow. The Character Dispiay tabie shows the 
case when an 8x8-dot character is defined. Figure 6-16 shows the character data address mapping. 


Character Data Format 


15 


12 11 


8 7 


PI 

PO 

2 pixels worth of data (8 bits/pixel) 


Character Display 


1 ^ 

PI 








































Figure 6-16 : Character Data Address Mapping (Affine BG) 
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6.2.3.4 256-Color x 16-Palette Character BG (Affine Extended BG) 

Select 256-Color x 16-Palette Character BG with the BG Control Register. Seiect the 256-Coior x 16- 
Paiette Character BG by seiecting Affine Extended BG as the BG type and setting the BG Controi Register 
Coior Mode to 0. 

Note: 256-Coior x 16-Paiette Character BG can be set oniy for BG2 and BG3. 

6.2.3.4.1 Screen Data Format 


15 


256-Color x 16-Palette BG Screen Data 

12 11 10 9 8 I 7 






VF 

HF 











Color Palette 

Flip 

Character Name 


• [d15-d12] : Coior Paiette 

When enabied, extended paiettes appiied to characters are specified in the range of 0-15. When 
extended paiettes are disabied, standard paiettes are used. Extended paiettes are enabied/disabied 
with the DISPCNT [DB_DISPCNT] Register. 

• [d11-d10] : Fiip 

• VF: Verticai Fiip Fiag HF: Horizontai Fiip Fiag 


0 

Do not flip 

1 

Flip 


• [d09-d00] : Character Name 

These bits specify the character number of the character that serves as the origin of the starting 
address for the character base biock specified by the BG Controi Register. 
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6.2.3.4.2 Character Data Format 

Character data format is the same as for 256-Color Mode Text BG. 

Figure 6-17 shows the character data address mapping. 

Character Data Format 

15 12 11 8 7 4 3 0 

PI PO 

2 pixels worth of data (8 bits/pixel) 
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6.2.4 Bitmap BG 

For Bitmap BG, BG screen composition eiements are treated as pixeis and the contents of VRAM (frame 
buffer) are dispiayed as coior data for each individuai screen pixei. 

Note: 256-Coior Bitmap BG and Direct-Coior Bitmap BG can be set oniy for BG2 and BG3. Large- 
Screen 256-Coior Bitmap BG can be set oniy for BG2 with the 2D Graphics Engine A. 

6.2.4.1 256-Color Bitmap BG (Affine Extended BG) 

Seiect 256-Coior Bitmap BG with the BG Controi Register. 

Seiect the 256-Coior Bitmap BG by seiecting Affine Extended BG as the BG type and setting the BG 
Controi Register Coior Mode to 1 and the Character Base Biock CBO to 0. 

6.2.4.1.1 Pixel Data Format 

The pixei data format for 256-Coior Bitmap BG is shown beiow. 

256-Color Bitmap BG Pixel Data Format 


7 







0 









Color Number 


6.2.4.1.2 Pixel Data VRAM Map 

The screen base address set in the BG Controi Register specifies (in 16KB units) the address in VRAM 
where the bitmap data is stored. The DISPCNT register's screen base offset vaiue is invaiid. 

6.2.4.2 Direct-Color Bitmap BG (Affine Extended BG) 

Seiect the Direct-Coior Bitmap BG with the BG Controi Register. 

Direct-Coior Bitmap BG can be seiected by seiecting Affine Extended BG as the BG type and setting the 
BG Controi Register Coior Mode to 1 and the Character Base Biock CBO to 1. 

6.2.4.2.1 Pixel Data Format 

The pixei data format for Direct-Coior Bitmap BG is shown beiow. 


15 


14 


Direct-Color Bitmap BG Pixel Data Format 

10 9 8 I 7 5 4 


















a 

BLUE 

GREEN 

RED 


6.2.4.2.2 Pixel Data VRAM Map 

The screen base address set in the BG Controi Register specifies (in 16KB units) the address in VRAM 
where the bitmap data is stored. The DISPCNT register's screen base offset vaiue is invaiid. 
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6.2.4.3 Large-Screen 256-Color Bitmap BG 

The Large-Screen 256-Color Bitmap BG cannot be used with 2D Graphics Engine B. 

6.2.4.3.1 Pixel Data Format 

The pixei data format for Large-Screen 256-Coior Bitmap BG is shown beiow. 


Large-Screen 256-Color Bitmap BG Pixel Data Format 


7 







0 









Color Number 


6.2.4.3.2 Pixel Data VRAM Map 

The starting address for pixei data is fixed to the starting address of BG-VRAM (0x6000000). Both the BG 
Controi Register's screen base address and the DISPCNT Register's screen base offset vaiue are invaiid. 
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6.2.5 BG Scroll 

For each Text BG screen, the display screen and its offset value can be set in dots. 

The Offset register is valid only for Text BG. Set the BG reference starting point (see " 6.2.6 BG Rotation 
and Scaling (Affine Transformation) " on page 130) to display Affine BG and Bitmap Mode BG with an 
offset. 


BG Offset Setting Registers 

Name Address Attribute Initial Value 

(2D_A) BGxOFS(x=0 - 3) 0x04000010, 0x04000014, 0x04000018, 0x0400001 C W 0x00000000 

(2D_B) DB_BGxOFS(x=0 - 3) 0x04001010, 0x04001014, 0x04001018, 0x0400101C W 0x00000000 


31 


24 


23 


16 


15 









































V Offset 








H Offset 


Figure 6-18 shows the offset for BG scrolling. 

Figure 6-18 : Offset Schematic 



Display Screen 
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6.2.6 BG Rotation and Scaling (Affine Transformation) 

The BG pixels are referenced horizontally in sequence from the top ieft when a BG is dispiayed, so a 
rotated BG can be dispiayed by rotating the reference direction. 

Figure 6-19 shows the rotation and scaiing process for a BG. 

Figure 6-19 : BG Rotation and Scaiing 



dx (reference distance in x-direction for same line) = (1/a)cos0 

dy (reference distance in y-direction for same line) = - (1/p)sin0 

dmx (reference distance in x-direction for next line) = (1/a)sin0 

dmy (reference distance in y-direction for next line) = (1/p)cos0 

Note: a is the scale ratio along the x-axis; p is the scale ratio along the y-axis. 

The (x2, y2) coordinates correspond to the (x1, y1) coordinates after affine transformation and are 
caicuiated with the foiiowing formuia: 


xl 

_ 

A B 

' o 

1 

- 1 - 

xO 

t2_ 


C D 

bl-TOj 


TO 


A = -COS0, B = -sin0, C = -^sin0, D = ^cos0 
a a p p 
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• BG Rotation and Scaling Process 

1. Using the equation above, calculate the results of affine transformation for the top-left coordinates 
of the display screen, and then set the results as the BG data reference start point in the following 
registers: 

• 2D Graphics Engine A BGxX, BGxY Registers (x=2, 3) 

• 2D Graphics Engine B DB BGxX, DB BGxY Registers (x=2, 3) 

Also, refer to " Figure 6-19 : BG Rotation and Scaling " on page 130, and set the BG data reference 
direction in the following registers: 

• 2D Graphics Engine A BGxPA, BGxPB, BGxPC, BGxPD Registers (x=2, 3) 

• 2D Graphics Engine B DB BGxPA, DB BGxPB, DB BGxPC, DB BGxPD Registers (x=2, 3) 

2. The image processing circuitry sums the cumulative increase in the x-direction (dx and dy) and 
calculates the x-direction coordinates in relation to the BG data reference start point set in these 
registers. 

3. If the line advances, the rendering start point coordinates for the next line are calculated by 
summing the cumulative increase in the y-direction (dmx and dmy) in relation to the reference start 
point. Then the process in Step 2 is performed. 

4. If the BG Data Reference Start Point Registers are overwritten during an H-Blank, the cumulative 
sum for the y-direction related to those registers is not computed. Use this mode to have the CPU 
change the affine transformation parameters and the center coordinates for each line. 

BG Data Reference Start Point Setting Registers 

Name Address Attribute Initial Value 

(2D_A) BGxX (x=2,3) 0x04000028, 0x04000038 W 0x00000000 

{2D_B) DB_BGxX (x=2,3) 0x04001028, 0x04001038 W 0x00000000 



Name Address Attribute Initiai Value 

(2D A) BGxY (x=2,3) 0x0400002070x04000030 W 0x00000000 

{2D_B) DB_BGxY (x=2,3) 0x04001020, 0x04001030 W 0x00000000 
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BG Data Reference Direction Setting Registers 

Name Address Attribute Initial Value 

(2D_A) BGxPA (x=2, 3) 0x04000020, 0x04000030 W 0x0100 

(2D_B) DB_BGxPA (x=2,3) 0x04001020, 0x04001030 W 0x0100 


15 

8 

7 

0 

S 

INTEGER_DX 

DECIMAL_DX 

Reference distance dx in x-direction for the same line 


Name Address Attribute Initial Value 

{2D_A) BGxPB (x=2,3) 0x04000022,0x0400032 W 0x0000 

(2D_B) DB_BGxPB (x=2,3) 0x04001022,0x0401032 W 0x0000 


15 

8 

7 

0 

S 

INTEGER_DMX 

DECIMAL_DMX 

Reference distance dmx in x-direction for the next line 


Name Address Attribute Initial Value 

(2D_A) BGxPC (x=2,3) 0x04000024,0x0400034 W 0x0000 

(2D_B) DB_BGxPC (x=2,3) 0x04001024,0x0401034 W 0x0000 


15 

8 

7 

0 

S 

INTEGER_DY 

DECII\/IAL_DY 

Reference distance dy in y-direction for the same line 


Name Address Attribute Initial Value 

{2D_A) BGxPD(x=2,3) 0x04000026,0x0400036 W 0x0100 

(2D_B) DB_BGxPD(x=2,3) 0x04001026,0x0401036 W 0x0100 


15 

8 

7 

0 

S 

INTEGER_DMY 

DECIMAL_DMY 

Reference distance dmy in y-direction for the next line 
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6.3 OBJ 

TWL can handle two types of OBJ: Character OBJ and Bitmap OBJ. Table 6-7 summarizes the features for 
both Character OBJ and Bitmap OBJ. 


Table 6-7 : OBJ Overview 


Item 

Character OBJ 

Bitmap OBJ 

Number of Display Colors 

1. Standard Palette 

16 colors X 16 palettes 

256 colors x 1 palette 

2. Extended Palette 

16 colors X 16 palettes (Standard Palette) 

256 colors x 16 palettes (Extended Palette) 

32,768 colors 

Number of Characters 
(Converted to 8x8-Dot) 

1. One-dimensional Mapping 

1,024 to 8,192 (16-color mode) 

512 to 4,096 (256-color mode) 

2. Two-dimensional Mapping 

1,024 (16-color mode) 

512 (256-color mode) 

1. ID Mapping 

1,024 to 2,048 

2. 2D Mapping 

256 

Character Size 

8x8 dot to 64x64 dot (12 varieties) 

Maximum Number Displayed 
on One Screen 

128 (converted to 64x64 dot) 

Maximum Number Displayed 
on One Line 

128 (converted to 8x8 dot) 

Features 

HV Offset, HV Flip, Affine Transformation, Translucence (see note). Mosaic, 

and Priority settings 


Note: See " 6.7 Color Special Effects " on page 170 to learn about OBJ color effects. 

• Other items 

See " 6.6 Windows " on page 166 to learn about OBJ windows. 

• Number of OBJ that can be displayed on one line 

Table 6-7 gives the capacity of OBJ that can be displayed on one line under the most efficient 
conditions. When display OBJ are positioned in series from the start of 0AM, the number of OBJ that 
can be displayed on one line is calculated as follows: 

(H dot count X 6 - 6)/rendering cycle count) = Number of OBJ displayable on 1 line (128 max.) 

H dot count \s normally 355 dots, but it becomes 256 dots if the DISPCNT [DB DISPCNT] Register’s 
OBJ Processing during H-Blank Period flag is set to 1 (see "5.2 LCD" on page 731 . 

X 6 represents the number of cycles that the OBJ rendering circuitry can use per dot. - 6 represents the 
number of cycles needed for the OBJ rendering pre-process at the start of the H-line. 

Table 6-8 shows the relation between the rendering cycle count and the number of OBJ that can be 
displayed on one line. 
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Table 6-8 : Rendering Cycle Count and Number of OBJ Displayable on One Line 


OBJ H-Size 

Render Cycle Count 

Number of OBJ Displayable on One Line 

Normal OBJ*^ 

Affine OBJ*^ 

Normal OBJ 

Affine OBJ 

8 

8 

26 

128 

81 

16 

16 

42 

128 

50 

32 

32 

74 

66 

28 

64 

64 

138 

33 

15 

128 

(Double-Sized 64) 

— 

266 

— 

7 


Note 1 : A Normal OBJ has the OBJ Mode of OBJ Attribute 0 set to Normal OBJ. 

Note 2: An Affine OBJ has the Affine Enabie Fiag of OBJ Attribute 0 set to Enabie. 

Tabie 6-8 shows vaiues under the most efficient conditions. Efficiency is actuaiiy iower because some OBJ 
in 0AM are outside of the rendered iine. Two cycies are iost for an OBJ outside of the rendered iine. 
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6.3.1 OBJ Display Control 

The overall configuration of OBJ features is performed with the DISPCNT Register for 2D Graphics Engine 
A and with the DB_DISPCNT Register for 2D Graphics Engine B. The settings for an individuai OBJ are 
configured with the OBJ Attribute Data stored in 0AM. (This subject is touched on iater.) 

Display Control Register (2D Graphics Engine A) 

Name: DISPCNT Address: 0x04000000 Attribute: R/W Initial Value: 0x00000000 



• OH [d23] : OBJ Processing during H-Biank Period Fiag 

When set to 0, the OBJ render process is performed during the entire H-iine period (inciuding the 
H-Biank period). 

When set to 1, the OBJ render process is performed oniy during the dispiay period, but not during the 
H-Biank period. In this case, the maximum number of OBJ cannot be dispiayed. 

Display Control Register 1 (2D Graphics Engine B) 

Name: DB DISPCNT Address: 0x04001000 Attribute: R/W Initial Value: 0x00000000 



• OH [d23] : OBJ Processing during H-Biank Period Fiag 

When set to 0, the OBJ render process is performed during the entire H-iine period (inciuding the 
H-Biank period). 

When set to 1, the OBJ render process is performed oniy during the dispiay period, but not during the 
H-Biank period. In this case, the maximum number of OBJ cannot be dispiayed. 


© 2008-2009 Nintendo 
CONFIDENTIAL 


135 


TWL-06-0017-001-D 
Released: February 16, 2009 




























TWL Programming Manual 


6.3.2 0AM 

An OBJ is displayed by storing data in Object Attribute Memory (0AM). A total of 128 sets of OBJ data can 
be written to the TWL Processor's internal 0AM (1 KB from 0x07000000 - 0x070003FF for 2D Graphics 
Engine A and 1 KB from 0x7000400 - 0x70007FF for 2D Graphics Engine B). Accordingly, a total of 128 
OBJ characters of any size can be displayed on the LCD. 

6.3.2.1 Memory Map 

48 bits X 128 sets of OBJ Attribute data can be written to 0AM. If an OBJ is to be rotated and scaled, a total 
of 32 groups of affine transformation parameters PA, PB, PC, and PD can be written to 0AM as shown in 
Figure 6-20. 

Figure 6-20 : 0AM Memory Map (Add 0x400h to 2D Graphics Engine B Addresses) 


0X070003FE 

Affine Transformation Parameter 

PD (31) 


0X070003F8 

Attribute 2 

OBJ 127 

Attribute 1 

Attribute 0 

0x07000008 

1 

1 

1 


Affine Transformation Parameter 

PB (0) 

Attribute 2 

OBJ 1 

Attribute 1 

Attribute 0 

0x07000000 

Affine Transformation Parameter 

PA (0) 


Attribute 2 

OBJ 0 

Attribute 1 

Attribute 0 


(16-bit Width) 
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6.3.2.2 0AM Data Format 


OBJ Attribute 0 



• [d15-d14] : OBJ Shape 

These bits set the shape of the OBJ. The number of dots in the OBJ's horizontai and verticai 
direction is determined by this setting and the OBJ size specification in OBJ Attribute 1. See OBJ 
Size under "OBJ Attribute 1" on page 139 . 


00 

Square 

01 

Long rectangle 

10 

Tall rectangle 

11 

Prohibited code 


• [d13] : Coior Mode 

This bit sets whether the OBJ character data is referenced in 16-coior format or 256-coior format. Be 
sure to set Coior Mode to 0 for Direct-Coior Bitmap OBJ settings. 



• [d11-d10] : OBJ Mode 

The 00 to 10 settings specify Character OBJ. When 10 (the OBJ Window) is specified, data is not 
dispiayed as normai OBJ; if there are dots of non-zero character data, the data is bandied as an OBJ 
window that can take any shape. See " 6.6 Windows " on page 166 for dispiay settings inside the OBJ 
window. The 11 setting specifies Bitmap OBJ. 


00 

Normal OBJ 

01 

Translucent OBJ 

10 

OBJ Window 

11 

Bitmap OBJ 
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• [d09] : Double-Size Flag for Affine Transformation 


0 

Disable double-size 

1 

Enable double-size 


When the d08 Affine Transformation Enable Flag is set to 1, the OBJ field can be doubled in size for 
display. Using a double-size OBJ field allows a rotated OBJ to be displayed in its entirety, without 
losing any sections. In addition, an OBJ can be enlarged up to double its original size and displayed 
without losing any sections (see Figure 6-21). 

When the d08 Affine Transformation Enable Flag is set to 0 and this bit to 1, the OBJ is hidden. 

Figure 6-21 : Affine Transformation of Doubie-Size OBJ Fieid 


Normal Display Rotated Display 



Enlarged Display using 
Double-Size OBJ Field 



Rotated Display using 
Double-Size OBJ Field 



• [d08] : Affine Transformation Enable Flag 

When this bit is enabled, the affine transformation parameters set in OBJ Attribute 1 are referenced. 

When this bit is disabled and the d09 Double-Size Flag for Affine Transformation is set to 1, the OBJ is 
hidden. 


0 

Disable 

1 

Enable 


• [d07-d00] : Y Coordinate 

These bits specify the OBJ's Y coordinate in the display screen in the range of 0 to 255. 
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OBJ Attribute 1 



• [d15-d14] : OBJ Size 

These bits set the OBJ size. The number of verticai and horizontai dots for an OBJ depends on this 
setting and the OBJ shape set in OBJ Attribute 0. Tabie 6-9 shows the reiationship. 


Table 6-9 : OBJ Sha 

pe and OBJ Size Settings 

OBJ Attribute 1 
OBJ size 

OBJ Attribute 0 

OBJ shape 

00 

01 

10 

11 

00 (Square) 

8x8 

16x16 

32x32 

64x64 

01 (Long rectangle) 

16x8 

32x8 

32x16 

64x32 

10 (Tall rectangle) 

8x16 

8x32 

16x32 

32x64 

11 (Prohibited setting) 

Prohibited Setting 


• [d13-d09] : Affine Transformation Parameter Seiection 

These bits specify which of the 32 sets of 0AM PA - PD affine transformation parameters to reference. 

When the OBJ Attribute 0 Affine Transformation Enabie Fiag is set to 0 (disabied), the [d13] VF bit is 
treated as the Verticai Fiip Fiag and the [d12] HF bit is treated as the Horizontai Fiip Fiag. 

• [d08-d00] : x Coordinate 

These bits specify the OBJ's x-coordinate in the dispiay screen in the range of 0 to 511. 
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OBJ Attribute 2 



• [d15-d12] : Color Parameter 

What these bits specify depends on whether OBJ Mode in OBJ Attribute 0 is set to Character OBJ or 
Bitmap OBJ. These bits specify the Color Palette Number for Character OBJ. They specify the Koam 
for Bitmap OBJ. The OCqaivi value is used as a factor for blending with the BG for the Bitmap OBJ (see 
" 6.3.4 Bitmap OBJ " on page 151). 

1. For Character OBJ: Color Palette Number 

This specifies one of 16 palettes to apply to the character data. 

This bit is invalid in 256-color mode when extended palettes are disabled (see "OBJ Attribute 0" on 
page 1371 . 

Extended palettes are enabled/disabled with the DISPCNT [DB DISPCNT] register. 

2. For Bitmap OBJ: Koam value 

The aoAM value is an element of the OBJ's transparency a, where a = ae^p x (aoAM +’')■ Set 
aBMP using the Bitmap OBJ data (see " 6.3.4.1 Bitmap OBJ Data " on page 153). 

• [dll-dIO] : Display Priority 

These bits set the order of priority for display. 

See " 6.9 Display Priority " on page 175 to learn about the priority relation with BG. 

The priority set with this bit is invalid when OBJ Mode in 0AM Attribute 0 is set to OBJ Window. See 
" 6.6 Windows " on page 166 to learn about the precedence of windows. 

• [d09-d00] : Starting Character Name 

The basic character number at the start of the OBJ character data mapped in OBJ-VRAM is written 
here. The specification in Bitmap OBJ mode is the same as for Character mode with 8x8-dot units. 

2D Mapping Mode 

When in 2D Mapping mode and 256-Color mode, the starting character name's lowest bit is fixed at 0. 
In addition, OBJ-VRAM references regions only up to 32 KB. 

1D Mapping Mode 

When in 1D Mapping mode, the capacity of OBJ-VRAM can be expanded (see the RAM Bank Control 
Registers 0 and 1 and the Display Control Register). 
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The boundary of the starting character name varies, as shown in Tabie 6-10 and Tabie 6-11, 
depending on the OBJ-VRAM capacity to aiiow the entire OBJ-VRAM region to be referenced with the 
setting region of the starting character name (10 bits). 

Table 6-10 : Character OBJ 


OBJ-VRAM Capacity 

Starting Character Name Boundary 

32 KB 

32 bytes 

64 KB 

64 bytes 

128 KB 

128 bytes 

256 KB 

256 bytes 


Table 6-11 : Bitmap OBJ 


OBJ-VRAM Capacity 

Starting Character Name Boundary 

128 KB 

128 bytes 

256 KB 

256 bytes 


Note: The maximum capacity of OBJ-VRAM is 128 KB for 2D Graphics Engine B because of restric¬ 
tions on VRAM aiiocation. Therefore, the Character OBJ and Bitmap OBJ capacity cannot be 
set to 256 KB. 
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Affine Transformation Parameters 

See " 6. 3.2.3 OBJ Rotation and Scaling (Affine Transformation) " on page 143 for how to determine the 
OBJ's affine transformation parameters. 

Affine Transformation Parameter PA 


15 

14 

8 

7 

0 

S_PA 

INTEGER_PA 

DECiMAL_PA 

Distance dx moved in x-direction on the same iine 


Signed fixed-point decimai (sign + 7-bit integer -i- 8-bit decimai part) 

Affine Transformation Parameter PB 


15 

14 

8 

7 

0 

S_PB 

INTEGER PB 

DECiMAL PB 

Distance dmx moved in x-direction on the next iine 


Signed fixed-point decimai (sign + 7-bit integer -i- 8-bit decimai part) 

Affine Transformation Parameter PC 


15 

14 

8 

7 

0 

S_PC 

INTEGER_PC 

DECiMAL_PC 

Distance dy moved in y-direction on the same iine 


Signed fixed-point decimai (sign + 7-bit integer -i- 8-bit decimai part) 

Affine Transformation Parameter PD 


15 

14 

8 

7 

0 

S_PD 

INTEGER_PD 

DECiMAL_PD 

Distance dmy moved in y-direction on the next iine 


Signed fixed-point decimai (sign + 7-bit integer -i- 8-bit decimai part) 
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6.3.2.3 OBJ Rotation and Scaling (Affine Transformation) 

The OBJ character data is referenced horizontally in sequence from the top left when an OBJ is displayed, 
so a rotated OBJ can be displayed by rotating the reference direction. The center of the rotation is fixed to 
the center of the OBJ field (dot boundary). If a reference point is outside the specified OBJ size, it becomes 
transparent. 

Figure 6-22 shows the rotation and scaling process for an OBJ. 

Figure 6-22 : OBJ Rotation and Scaling 

Origin (0,0) X Axis ^ 



dx (reference distance in x-direction for same line) = {1/a)cos0 

dy (reference distance in y-direction for same line) = - {1/p)sin9 

dmx (reference distance in x-direction for next line) = (1/a)sin0 

dmy (reference distance in y-direction for next line) = (1/p)cos0 

Note: a is the scale ratio along the x-axis; p is the scale ratio along the y-axis. 

OBJ Rotation and Scaling Process 

1. Affine transformation parameter numbers to be applied are specified in OBJ Attribute 1 registered 
in 0AM. In addition, the affine transformation parameters PA, PB, PC, and PD to be applied are 
set in 0AM using the information in Figure 6-22. 

2. The image-processing circuitry calculates the coordinates in the x-direction in relation to the data 
reference start point that uses the center of the OBJ field as the center of rotation by summing the 
cumulative increase in the x-direction (dx and dy). 

3. If the line advances, the rendering start point coordinates for the next line are calculated by 
summing the cumulative increase in the y-direction (dmx and dmy) in relation to the reference 
starting point. Then the process in Step 2 is performed. 


© 2008-2009 Nintendo 
CONFIDENTIAL 


143 


TWL-06-0017-001-D 
Released: February 16, 2009 






TWL Programming Manual 


6.3.3 Character OBJ 

For OBJ character data, 8x8-dot sections are treated as basic characters and are assigned a Character 
Number. The OBJ size can be from 8x8 dots to 64x64 dots (12 different sizes). The OBJ character data 
base address is fixed as the VRAM base address. OBJ are defined as having either 16 coiors or 256 
coiors, so the definition of a singie basic character requires either 32 bytes or 64 bytes (both have the 
same format as BG character data). 

The Coior Mode setting in 0AM OBJ Attribute 1 defines whether to reference OBJ character data in 
16-coior format or 256-coior format. In addition, the paiette specified in OBJ Attribute 2 is used when 
16-coior mode has been set or when 256-coior mode is set when extended paiettes are enabied. Extended 
paiettes can be enabied/disabied with the DISPCNT [DB DISPCNT] Register. 

Seiect either 1D Mapping or 2D Mapping for character data VRAM mapping. 

Display Control Register (2D Graphics Engine A) 

Name: DISPCNT Address: 0x04000000 Attribute: R/W Initial Value: 0x00000000 



• [d22-d20] : OBJ-VRAM Region Extended Fiag 

• CH [d21-d20] : VRAM Region Extended Fiag for Character OBJ 

These bits specify OBJ-VRAM capacity when OBJ character data uses 1D mapping. When set to 
00, the capacity is the same as the AGB. Tabie 6-12 shows the starting character name 
boundaries that can be specified with 0AM OBJ Attribute 2. 


Table 6-12 : Starting Character Name Boundaries for OBJ Attribute 2 


00 

32 KB (Starting character name boundary: 32 bytes) 

01 

64 KB (Starting character name boundary: 64 bytes) 

10 

128 KB (Starting character name boundary: 128 bytes) 

11 

256 KB (Starting character name boundary: 256 bytes) 


Note: When the OBJ-VRAM Region Setting fiag has been set greater than the VRAM size aiiocated to 
the OBJ, do not access the region that exceeds the VRAM size aiiocated to the OBJ. 
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• [d06-d04] : OBJ Data Mapping Mode 

• CH [d04] : Character OBJ Data Mapping Mode 


0 

2D mapping 

1 

1D mapping 


In 2D mapping mode, oniy up to 32 KB of OBJ-VRAM can be referenced. 

In 1D mapping mode, a capacity of 32 to 256 KB can be set with the OBJ-VRAM Region Extended 
Fiag. Accordingiy, more OBJ characters can be defined in OBJ-VRAM using 1D mapping mode. 

Display Control Register 1 (2D Graphics Engine B) 

Name: DB DISPCNT Address: 0x04001000 Attribute: R/W Initial Value: 0x00000000 



• [d21-d20] : OBJ-VRAM Region Extended Fiag 

• CH [d21-d20] : VRAM Region Extended Fiag for Character OBJ 

These bits specify OBJ-VRAM capacity when OBJ character data uses 1D mapping. When set to 
00, the capacity is the same as the AGB. Tabie 6-13 shows the starting character name 
boundaries that can be specified with 0AM OBJ Attribute 2. 


Table 6-13 : Starting Character Name Boundaries for OBJ Attribute 2 


00 

32 KB (starting character name boundary: 32 bytes) 

01 

64 KB (starting character name boundary: 64 bytes) 

10 

128 KB (starting character name boundary: 128 bytes) 

11 

256 KB (starting character name boundary: 256 bytes) 


Note: With 2D Graphics Engine B, the maximum size that can be aiiocated to VRAM is 128 KB. 
When the OBJ-VRAM Region Setting fiag has been set greater than the VRAM size 
aiiocated to the OBJ, do not access the region that exceeds the VRAM size aiiocated to 
the OBJ. 

• [d06-d04] : OBJ Data Mapping Mode 

• CH [d04] : Character OBJ Data Mapping Mode 


0 

2D mapping 

1 

1D mapping 


In 2D mapping mode, oniy up to 32 KB of OBJ-VRAM can be referenced. 

In 1D mapping mode, a capacity of 32 to 256 KB can be set with the OBJ-VRAM Region Extended 
Fiag. Accordingiy, more OBJ characters can be defined in OBJ-VRAM using 1D mapping mode. 
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6.3.3.1 Character Data Format 

The character data format for Character OBJ is shown below. The Character Display table shows the case 
when an 8x8-dot character is defined. 

6.3.3.1.1 16-Color Mode 

The character data format for 16-color mode, correspondence between character display and pixel data, 
and address mapping (Figure 6-23) are shown below. 


16-Color Mode 

1 15 12 11 8 

Character Data 

7 4 3 0 1 

P3 

P2 

P1 

PO 

4 pixels worth of data (4 bits/pixel) 


Character Display 


PO 

P1 

P2 

P3 






























Figure 6-23 : Character Data Address Mapping (16-Color Mode Character OBJ) 
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6.3.3.1.2 256-Color Mode 

The character data format for 256-color mode, correspondence between character display and pixel data, 
and address mapping (Figure 6-24) are shown beiow. 


12 11 


PI 


256-Color Mode Character Data 

8 I 7 


2 pixels worth of data (8 bits/pixel) 


Character Display 


4 3 


PO 


PO 

P1 
































Figure 6-24 : Character Data Address Mapping (256-Color Mode Character OBJ) 


8 bits of data for each dot 
(specify 1 of 256 colors) ' 
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20 
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24 

25 

26 

27 

28 

29 

30 

32 

33 

34 

35 

36 

37 

38 

40 

41 

42 

43 

44 

45 

46 

48 

49 

50 

51 

52 

53 
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56 
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61 
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6.3.3.2 Mapping Modes for Character OBJ Data 
6.3.3.2.1 2D Mapping 

When displaying 256-coior x 1 -paiette characters in 2D mapping mode, the character name specification is 
iimited to even numbers, as shown in Figure 6-25. 

Figure 6-25 : 2D Mapping 


f 8x32 Dots 

(16-Color Mode) (256-Color Mode) 
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002h 
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020h 
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6.3.3.2.2 1D Mapping 

The address where the data that makes up the character is stored is consecutive for each character, as 
shown in Figure 6-26 and Figure 6-27. 

Figure 6-26 : 1D Mapping when Character Name Boundary is 32 Bytes 


Address Character Name Character Name 

Offset VRAM Map OBJ Image Map 
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(16-Color Mode) 
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01 Ah 

01 Bh 
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(256-Color Mode) 
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0x0320 

019h 


012h 

013h 



0x0300 






017h 


014h 

015h 




016h 

8 X 32 Dots 





(256-Color Mode) 

016h 

017h 



0x0220 

011h 






• •-•**** 





0x0200 


.. 
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002h 

003h 


OOFh 













OOEh 

32 X 32 Dots 
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007h 









(16-Color Mode) 
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0x0020 
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0x0000 
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Figure 6-27 : 1D Mapping when Character Name Boundary is 128 Bytes 


Address Character Name Character Name 

Offset VRAM Map OBJ Image Map 
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6.3.4 Bitmap OBJ 

The VRAM Extended Flag and Mapping Mode for Bitmap OBJ are set with the DISPCNT [DB DISPCNT] 
Register. 


Display Control Register (2D Graphics Engine A) 

Name: DISPCNT Address: 0x04000000 Attribute: R/W Initial Value: 0x00000000 



• [d22-d20] : OBJ-VRAM Region Extended Fiag 

• BM [d22] : VRAM Extended Fiag for Bitmap OBJ 

These bits specify OBJ-VRAM capacity when 1D mapping is seiected for OBJ bitmap data. 


0 

128 KB (starting character name boundary of 128 bytes) 

1 

256 KB (starting character name boundary of 256 bytes) 


• [d06-d04] : OBJ Data Mapping Mode 

• BM [d06-d05] : Bitmap OBJ Data Mapping Mode 


00 

2D mapping with 128 horizontal dots 

01 

2D mapping with 256 horizontal dots 

10 

1D mapping 

11 

Prohibited Setting 


The OBJ-VRAM Region Extended Fiag is ignored with 2D mapping. In this case, OBJ-VRAM is 
referenced in a range of addresses that can be specified by the 10-bit character name set by OBJ 
Attribute 2 in 0AM. 

Capacity is set with the OBJ-VRAM Region Extended Fiag with 1D mapping. 
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DB_DISPCNT: Display Control Register 1 (2D Graphics Engine B) 

Name: DB DISPCNT Address: 0x04001000 Attribute: R/W Initial Value: 0x00000000 



• [d06-d04] : OBJ Data Mapping Mode 

• BM [d06-d05] : Bitmap OBJ Data Mapping Mode 


00 

2D mapping with 128 horizontal dots 

01 

2D mapping with 256 horizontal dots 

10 

ID mapping 

11 

Prohibited Setting 


In 2D mapping mode, oniy up to 32 KB of OBJ-VRAM can be referenced. 

In 1 D mapping mode, OBJ-VRAM capacity is set to 128 KB. 

Note: With 2D Graphics Engine B, a maximum of 128 KB can be aiiocated to VRAM. 

Accordingiy, aithough it can be specified for 2D Graphics Engine A, the OBJ-VRAM 
capacity for 1D mapping mode is fixed to 128 KB. 
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6.3.4.1 Bitmap OBJ Data 


Bitmap OBJ data 

15 14_10 9 8 I 7_5 4_0 


A 

BLUE 

GREEN 

RED 

OCbmp 

PO 


• A [d15] : OCgivip 

The agiy/ip value is an element of the OBJ's transparency a, where a = agyp x (uoam +’')■ Set Uoam 
using OBJ Attribute 2 (see " 6. 3.2.2 QAM Data Format " on page 137). 


OBJ Dispiay 


PO 









































6.3.4.2 Biending with BG 

As with translucent OBJ, Bitmap OBJ can be blended with the BG of the second target screen for display. 
When aoAM = 0’ the entire region of the OBJ becomes transparent and is not rendered. When aoAM is 
non-zero, the OBJ is blended for display according to the following formula: 

„ X a -I-Cgg X (16 - a) 

16 

(X = bCgJVjp X ( + 1 ) 

tteMP is set with Bitmap OBJ data, and aoAM is a value specified with OBJ Attribute 2 of 0AM. 
c is the color of the blending result (calculation results are rounded to the nearest integer). 

Cqbj is the Bitmap OBJ color of the first target screen. 

Cbg is the BG color of the second target screen. 
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6.3.4.3 Mapping Modes for Bitmap OBJ Data 
6.3.4.3.1 2D Mapping with 128 Horizontal Dots 

Figure 6-28 shows the 2D map of Bitmap OBJ data with 128 horizontai dots in VRAM. 


Figure 6-28 : 2D Map of Bitmap OBJ Data VRAM (128 Horizontal Dots) 
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Character names are set in units of 8x8 dots (128 bytes) of bitmap data. Figure 6-29 shows the 2D image 
map of character names in VRAM. 


Figure 6-29 : 2D Image Map of Character Name VRAM 
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6.3.4.3.2 2D Mapping with 256 Horizontai Dots 

Figure 6-30 shows the 2D map of Bitmap OBJ data with 256 horizontai dots in VRAM. 


Figure 6-30 : 2D Map of Bitmap OBJ Data VRAM (256 Horizontai Dots) 
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Character names are set in units of 8x8 dots (128 bytes) of bitmap data. Figure 6-31 shows the 2D image 
map of character names in VRAM. 

Figure 6-31 : 2D image Map of Character Name VRAM 
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6.3.4.3.3 1D Mapping 
Character Names 

In 2D Graphics Engine A, the Bitmap OBJ VRAM extension fiag in the dispiay controi register DISPCNT 
changes both the OBJ-VRAM range that can be specified by a character name, and the character name 
boundary (see Tabie 6-14). 

In 2D Graphics Engine B, VRAM aiiocation is restricted, so the OBJ-VRAM range is fixed to 128 KB, and 
the character name boundary is fixed to 128. 


Table 6-14 : Character Name Boundaries 


Bitmap OBJ 

VRAM Extended Flag 

OBJ-VRAM Specifiable Range 

Character Name Boundary 

0 

128 KB 

128 bytes 

1 

256 KB 

256 bytes 


For exampie, if the VRAM Extended Fiag for Bitmap OBJ is set to 0, and the OBJ Attribute 2 setting for 
Starting Character Name is set to 4Ch, the Bitmap OBJ data defined from address 0x2600 (= 4Ch x 128 
bytes) is referenced. 

ID VRAM Mapping of Bitmap OBJ Data 

Map bitmap data from the starting address of the character name boundary for the size of the character. 
This size is not in units of 8x8 dots. Figure 6-32 and Figure 6-33 show the 1D map for 8x8-dot characters 
and 16x16-dot characters. In these figures, c+xxh denotes the offset from the starting address of the 
character name boundary. 


Figure 6-32 : ID Map of VRAM with 8x8-Dot Characters 
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Figure 6-33 : 1D Map of VRAM with 16x16-Dot Characters 
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6.4 Backdrop 

The 2D graphics displayed on the LCD are composed of OBJ, BG, and the Backdrop. An OBJ is a 
relatively small image, but several of them can be displayed. They are mainly used to display characters 
that move around the screen. A BG has features equivalent to an OBJ, but only a few BG screens can be 
displayed because a BG is large and consumes a lot of memory. A BG is used to display large images 
such as objects that are continuously on-screen or in the background. 

On TWL, regions of the LCD screen where no OBJ and BG are displayed are filled with a single color. This 
region is called the Backdrop and can be visualized as a single-color surface that is always displayed 
furthest in the back, as depicted in Figure 6-34. The Backdrop is a surface filled only with a single color and 
does not have the features of OBJ and BG. The Backdrop color can be changed with the palette (see " 6.5 
Color Palettes " on page 159). 

Figure 6-34 : Backdrop Schematic 
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6.5 Color Palettes 

As a standard feature, TWL has RAM allocated specifically for BG and OBJ palettes (Palette RAM). Data 
stored in Paiette RAM are caiied standard paiettes. 

A BG or OBJ can be dispiayed using just a standard paiette, but extended paiettes aiiow the use of 256 
coiors X 16 paiettes and enabie richer visuais. To use extended paiettes, aiiocate VRAM using the RAM 
Controi Register and enabie the Extended Paiette Fiag with the DISPCNT [DB DISPCNT] Register. 

6.5.1 Standard Palettes 

Standard paiette RAM is aiiocated separateiy for OBJ and for BG in both 2D Graphics Engine A and 2D 
Graphics Engine B. Coior 0 in each paiette is the transparent coior, regardiess of the settings. The 
Backdrop screen uses the coior set at the beginning of the BG paiette (Coior 0 of Paiette 0). Because 
standard paiette RAM resides inside the 2D Graphic Engines, the 2D Graphic Engine must be enabied in 
the Power Controi Register (POWCNT) before data can be written to its RAM. 

Figure 6-35 shows the standard paiette RAM addresses. Figure 6-36 shows the coior specifications for 16 
Coiors X 16 Paiettes. Figure 6-37 shows the coior specifications for 256 Coiors x 1 Paiette. 

Figure 6-35 : Standard Palette RAM Addresses (Add +0x400 for 2D Graphics Engine B) 


0X050003FF 

OBJ Palette RAM 
(512 bytes) 

0x05000200 


0x050001FF 

BG Palette RAM 
(512 bytes) 

0x05000000 



Figure 6-36 :16 Colors x 16 Palettes 
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Figure 6-37 : 256 Colors x 1 Palette 
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The format for color data is shown below. 


Color Data Format 

15 14 10 9 8 I 7 5 4 0 


GREEN 

BLUE 

GREEN 

RED 


Color Data 


Note: The 15th bit of the coior data is used as the iowest-order green bit. The iowest-order biue and red 
bits are extended with a 0, and the RGB vaiues are caicuiated using 6 bits each. 


Color Data 


6.5.2 Extended Palettes 

OBJ and each BG screen can be allocated 256 colors x 16 palettes (8 KB) of VRAM by setting the 
Extended Paiette Fiag in the DISPCNT [DB DISPCNT] Register and the RAM Bank Controi Register. 
When aiiocated, paiette siots are not mapped to the CPU bus. To rewrite the paiette data, the paiette siot 
must be aiiocated to LCDC. 

6.5.2.1 BG Extended Palettes 

Display Control Register (2D Graphics Engine A) 

Name: DISPCNT Address: 0x04000000 Attribute: R/W Initial Value: 0x00000000 
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Display Control Register 1 (2D Graphics Engine B) 

Name: DB DISPCNT Address: 0x04001000 Attribute: R/W Initial Value: 0x00000000 



© 2008-2009 Nintendo 
CONFIDENTIAL 


161 


TWL-06-0017-001-D 
Released: February 16, 2009 













TWL Programming Manual 


• [d31 ,d30] : Extended Palette Enable Flag 

• BG [d30] : BG Extended Palette 

This flag is vaiid for BG screens that can be dispiayed with 256 Coiors x 16 Paiettes. 


0 

Disable (256 colors x 1 palette) 

1 

Enable (256 colors x 16 palettes) 


The standard paiette is aiways used for BG screens that do not support 256 Coiors x 16 Paiettes, 
even if BG Extended Paiettes are enabied. In addition, the Backdrop screen aiways uses Coior 0 
of the standard paiette. 

To use BG extended paiettes, VRAM must be aiiocated to the BG Extended Paiette Siots. See the 
RAM Bank Controi Register for aiiocating VRAM to the BG Extended Paiette Siots. 

BG Extended Palette Slots 

BG Extended Paiettes can have up to 32 KB aiiocated to Siots 0-3. Whether BGO uses Siot 0 or Siot 2 is 
seiected with the BGO Controi Register, and whether BG1 uses Siot 1 or Siot 3 is seiected with the BG1 
Controi Register. BG2 can use oniy Siot 2, and BG3 can use oniy Siot 3. Therefore, if Siot 0 is set to BGO 
and Siot 1 to BG1, each BG screen can use its own extended paiette. On the other hand, by setting Siots 2 
and 3 to be shared by aii BG screens, the BG Extended Paiettes can conserve 16 KB. 

Coior 0 in both paiettes is the transparent coior, regardiess of the settings. The Backdrop screen uses the 
coior set at the beginning of the BG standard paiette (Coior 0 of Paiette 0). 

Figure 6-38 shows the memory map for BG extended paiette siots. 


Figure 6-38 : BG Extended Palette Memory Map 
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Table 6-15 lists the palettes that can be used by each type of BG. 


Table 6-15 : Palettes and BG Types 





Colors/ 

Palette 

BG 

Screen 

Usable Palette Region 

Category 


BG Type 

Standard 

Extended Palette Slot 






0 

1 

2 

3 




16/16 

BGO-3 

X 









BGO 

X 

X 


X 




Text BG 

256/16 

BG1 

X 


X 


X 

Character 



BG2 

X 



X 


BG 




BG3 

X 




X 


Affine BG 

256/1 

BG2-3 

X 







256-Color x 16- 

256/16 

BG2 

X 



X 



Ext. 

Palette BG 

BG3 

X 




X 

Bitmap 

BG 

BG 

256-Color 

256/1 

BG2-3 

X 






Direct Color 

32,768 

BG2-3 







Large-Screen 256-Color 

256/1 

BG2 

X 






As shown in Figure 6-15, the Extended Palette Slot number can be selected for BGO and for BG1. With 2D 
Graphics Engine B, Large-Screen 256-Color Bitmap BG cannot be selected for the BG type. See the 
section on the BG Control Register in " 6.2.2 BG Control " on page 105 to learn how to select slots. 
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6.5.2.2 OBJ Extended Palettes 


Display Control Register (2D Graphics Engine A) 

Name: DISPCNT Address: 0x04000000 Attribute: R/W Initial Value: 0x00000000 



Display Control Register 1 (2D Graphics Engine B) 

Name: DB DISPCNT Address: 0x04001000 Attribute: R/W Initial Value: 0x00000000 



• [d31 ,d30] : Extended Palette Enable Flag 

• O [d31] : OBJ Extended Palette 


0 

Disable (256 colors x 1 palette) 

1 

Enable (256 colors x 16 palettes) 


The standard palette (palette RAM) is always used for 6-Color Mode OBJ, even if OBJ Extended 
Paiettes are enabied. See " 6.5 Coior Paiettes " on page 159 for more information on these 
paiettes. 

To use OBJ extended paiettes, VRAM must be aiiocated to the OBJ Extended Paiette Siots. See 
the RAM Bank Controi Register for aiiocating VRAM to the OBJ Extended Paiette Siots. 
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OBJ Extended Palette Slots 

Although 16 KB of VRAM is allocated to the OBJ extended palettes, only 8 KB of this can be used as an 
extended paiette. As Figure 6-39 iiiustrates, oniy Siot 0 can be used as an extended paiette; Siot 1 is 
invaiid. 

Coior 0 for each paiette is bandied as the transparent coior, regardiess of the settings. The Backdrop 
screen uses the coior set at the beginning of the standard BG paiette (Coior 0 of Paiette 0). 


Figure 6-39 : 

0x00004000 

OBJ Extended Palette Slot Memory Map 

0x00002000 

Slot 1 (Invalid Region) 

0x00000000 

SlotO 
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6.6 Windows 

Window features can restrict the regions where BG and OBJ screens are dispiayed as weii as the region 
where coior speciai effects are appiied. TWL uses three kinds of windows: Window 0, Window 1, and the 
OBJ Window (see OBJ Attribute 0 in "6.3 OBJ" on page 133 to read about the OBJ Window settings). 

Window Interior Control Register 

Name Address Attribute Initial Value 

(2D_A) WININ 0x04000048 R/W 0x0000 

(2D_B) DB_WININ 0x04001048 R/W 0x0000 


15 


13 


12 




EFCT 

OBJ 

BG3 

BG2 

BG1 

BGO 



EFCT 

OBJ 

BG3 

BG2 

BG1 

BGO 

Inside Window 1 

Inside Window 0 


Window Exterior and OBJ Window Interior Control Register 

Name Address Attribute Initial Value 

(2D A) WINOUT 0x0400004a Sw 0x0000 

{2D_B) DB_WINOUT 0x0400104A R/W 0x0000 



Display control over the window’s exterior is valid whenever Window 0, Window 1, or the OBJ Window is 
displayed. 
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Window Position Setting Register 

Name Address Attribute Initial Value 

(2D_A) WINxH(x=0, 1) 0x04000040,0x04000042 W 0x0000 

(2D_B) DB_WINxH(x=0, 1) 0x04001040, 0x04001042 W 0x0000 


15 


















Window Top Left x-coordinate 

Window Bottom Right x-coordinate 


• [dl 5-d08] : Window Top-Left x-coordinate 
Set this in the range between 0 and 255. 

• [d07-d00] : Window Bottom-Right x-coordinate 
Set this in the range between 0 and 255. 


Name Address Attribute Initial Value 

(2D_A) WINxV (x=0, 1) 0x04000044, 0x04000046 W 0x0000 

(2D_B) DB_WINxV (x=0, 1) 0x04001044, 0x04001046 W 0x0000 


15 


















Window Top Left y-coordinate 

Window Bottom Right y-coordinate 


• [dl 5-d08] : Window Top-Left y-coordinate 
Set this in the range between 0 and 191. 

• [d07-d00] : Window Bottom-Right y-coordinate 
Set this in the range between 0 and 192. 

Window Range 

If the window's top-ieft coordinates are (ix, iy) and the bottom-right coordinates are (rx, ry), the window 
range for LCD coordinates (0, 0) - (255, 191) is (ix, iy) - (rx-1, ry-1). 

To iocate a window aiong the right side of the LCD screen, set its bottom-right x-coordinate to 0. To iocate 
a window aiong the ieft side of the LCD screen, set the top-ieft x-coordinate to 0. However, if both x- 
coordinates are set to 0, the window is not dispiayed. Consequentiy, the window cannot span the entire 
LCD screen width. Use another window (or the OBJ Window) to span the entire width of the LCD screen 
with windows. 

Note: If the circuit revisions to the 2D graphics engine are enabied in the system configuration in TWL 
mode, the window width can be made to span the entire width of the LCD by setting x-coordinates 
of both the upper ieft and the iower-right coordinates to 0. (This is set using the SCFG_EXT 
register.) 

Window Shape 

Window 0 and Window 1 can be set oniy as rectanguiar shapes. However, the shape’s appearance can be 
aitered by overwriting the Window Position Setting Register during an H-Biank period (see Figure 6-40). 
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Figure 6-40 : Altering a Window Shape 

Screen Screen 
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6.6.1 Precedence of Windows 

As shown in Figure 6-41, Window 0 aiways has dispiay priority (precedence) over Window 1, and the OBJ 
Window has the iowest precedence. The precedence cannot be changed. 

Figure 6-41 : Display Priority of Window 0, Window 1, and the OBJ Window 

Screen 



Note 1 Regarding Windows: When the top-ieft y-coordinate of the window is between 0 and 6, 
the top-ieft y-coordinate is forcibiy dispiayed as though it were 0. Use one of the foiiowing two 
methods to work around this probiem. 

Note: If the circuit revisions to the 2D graphics engine are enabied in the system configuration in 
TWL mode, this probiem wiii be avoided. (This is set using the SCFG_EXT register.) 

Method 1: Perform the following steps: 

1. Set the window's y-coordinate to a vaiue of 7 or higher before the V-Count reaches 256 during 
the V-Biank process. 

2. Restore the window's y-coordinate to its originai vaiue after confirming that V-Count has 
reached 262 by checking V-Count using a V-Count Match Interrupt or an H-Blank Interrupt. 

Method 2: Perform the following steps: 

1. Set the Window Dispiay Enabie Fiag in the Dispiay Controi Register, using the vaiues shown 
beiow after confirming that V-Count has reached 262 by checking V-Count using a V-Count 
Match Interrupt or an H-Blank Interrupt. 

When the window y-coordinate is 0: 1 (Show window) 

When the window y-coordinate is non-zero: 0 (Hide window) 

2. Read the V-Count vaiue using an H-Biank Interrupt and compare that value to (window y- 
coordinate - 1). If the two values are equal, set the Window Display Enable Flag in the Display 
Control Register to 1 (Show window) during the H-Blank. 

Note 2 Regarding Windows: Immediately after drawing a line in which the bottom-right x 
coordinate is set to 0, drawing of the current window will not be complete at H-Blank. If the 
coordinates of the next window are set in this state, the window will continue drawing up to the 
bottom-right x coordinate of the next window. 

To avoid this, you must wait until the window has finished drawing before setting the coordinates of 
the next window. If the bottom-right x coordinate is 0, the window will finish drawing 3 clock cycles 
of the system clock (33 MHz) after the H-Blank flag changes from 1 to 0 (or the V-Count value 
increments by 1). Between this time and the time when the H-Count reaches the top-left x coordi- 


© 2008-2009 Nintendo 
CONFIDENTIAL 


169 


TWL-06-0017-001-D 
Released: February 16, 2009 




TWL Programming Manual 


nate of the next window, it wiii be outside the window. So set the coordinates for the next window 
during this period. Note that you cannot use this method when setting window coordinates using 
H-Biank-initiated DMA. 

6.7 Color Special Effects 

OBJ and BG can use the aipha-biending and fade-in/fade-out coior speciai effects. These effects can be 
iimited to a region by using windows (see " 6.6 Windows " on page 166). Tabie 6-16 summarizes coior 
speciai effects. 


Table 6-16 : Color Special Effects 


Color Special Effect 

Result 

Alpha-Blending 

Computations are conducted and a 16-level translucency process is performed on two 
selected screens. 

This process is not performed on transparent portions (transparent pixels). 

Brightness Up/Down 
(Fade-in/Fade-out) 

Computations are conducted and a 16-level process of changing the brightness is 
performed on the selected screen. 

This process is not performed on transparent portions (transparent pixels). 


Color Special Effect Control Register 

Name Address Attribute Initial Value 

(2D_A) BLDCNT 0x04000050 R/W 0x0000 

(2D_B) DB_BLDCNT 0x04001050 R/W 0x0000 



Color special effects are set with the BLDCNT [DB_BLDCNT] Register. For alpha-blending, which 
processes two screens, the two target screens must have the proper priority. In addition, translucent OBJ 
are specified separately in 0AM and the BLDCNT [DB BLDCNT] Register specifies color special effects 
for the entire OBJ. 
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• [d07-d06] : Special Effect Selection 


Table 6-17 : Color Special Effects and Processing 


Effect Selection 

Type 

Description of the Color Special Effect Processing 

d07 

d06 

0 

0 

None 

Normally, color special effect processing Is not performed. 

However, 16-level translucency processing (alpha-blending) is performed only 
if a second target screen is directly behind a translucent OBJ, Bitmap OBJ, or a 
3D surface is rendered to a BGO screen. 

0 

1 

Alpha- 

Blending 

16-level translucency processing (alpha-blending) is performed only if a second 
target screen is directly behind the first target screen. 

Set the first target screen's Backdrop screen bit to off ([d05] = 0). 

If OBJ = 1 for the first target screen, processing is executed on all OBJ, 
regardless of type. If OBJ = 0, processing is executed only for translucent OBJ, 
Bitmap OBJ, or a 3D surface rendered to a BGO screen. 

1 

0 

Brightness 

Up 

(see note) 

Gradually increases the brightness of the first target screen. If the first target 
screen specifies OBJ = 1, processing is executed only for normal OBJ. alpha¬ 
blending is always performed when a second target screen is directly behind a 
translucent OBJ, Bitmap OBJ, or 3D surface rendered to a BGO screen. 

1 

1 

Brightness 
Down 
(see note) 

Gradually decreases the brightness of the first target screen. If the first target 
screen specifies OBJ = 1, processing is executed only for normal OBJ. alpha¬ 
blending is always performed when a second target screen is directly behind a 
translucent OBJ, Bitmap OBJ, or 3D surface rendered to a BGO screen. 


Note: As stated in Tabie 6-17, aipha-biending is aiways performed on transiucent OBJ, Bitmap OBJ, 
and BOO rendered with a 3D surface and a second target screen, where the second target 
screen is directiy behind, regardiess of the Speciai Effect Seiection setting. Therefore, to use 
Fade-in/Fade-out with these screens, do not specify a second target screen (ciear aii) or piace 
something other than a second target screen immediateiy behind these screens. 
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1. Alpha-Blending 


Color Special Effect Alpha-Blending Factor Register 

Name Address Attribute Initial Value 

(2D_A) BLDALPHA 0x04000052 R/W 0x0000 

(2D_B) DB_BLDALPHA 0x04001052 R/W 0x0000 


15 


12 





















EVB 




EVA 


The factors used for alpha-blending are set with EVA and EVB in the BLDALPHA [DB BLDALPHA] 
Register. EVA and EVB are divided by 16 and are used as the pixel color factors in the equations 
below (when EVA or EVB exceeds 16, it is reset to 16). 


Note that when a Bitmap OBJ is blended with the second target screen, the Bitmap OBJ's alpha value 
is used instead of these values. For further details, see " 6.3.4 Bitmap OBJ " on page 151 and " 6.3.4.2 
Blending with BG " on page 153. 

• Computations for alpha-blending (16 levels of translucency) 

Display color (R) = 1st pixel color (R) x (EVA /16) + 2nd pixel color (R) x (EVB /16) 

Display color (G) = 1 st pixel color (G) x (EVA /16) + 2nd pixel color (G) x (EVB /16) 

Display color (B) = 1 st pixel color (B) x (EVA /16) -i- 2nd pixel color (B) x (EVB /16) 

The computation results for alpha-blending are rounded to the nearest integer. 

Note: An OBJ cannot be alpha-blended with another OBJ. 

Figure 6-42 shows a case where an OBJ is specified as the first target screen, and a BG and an OBJ 
are specified as the second target screen. In this situation, OBJ-B is ignored as the target pixels for 
alpha-blending, and alpha-blending is carried out with OBJ-A and BG, just as if the BG were located 
directly behind OBJ-A. 

Figure 6-42 : Alpha-Blending Display Priority 
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2. Brightness Up/Down 

Color Special Effect Brightness Change Factor Register 

Name Address Attribute Initial Value 

(2D_A) BLDY 0x04000054 W 0x0000 

(2D_B) DB_BLDY 0x04001054 W 0x0000 

I 15 _ 8 I 7 _^ 

EVY 

The factor used for changing brightness is set with EVY in the BLDY [DB_BLDY] Register. EVY is 
divided by 16 and is used as the pixei coior factor in the equations beiow (when EVY exceeds 16, it is 
reset to 16.) 

• Computations to increase brightness 

Dispiay coior (R) = 1st pixei (R) + (31 - 1st pixei (R)) x (EVY /16) 

Dispiay coior (G) = 1 st pixei (G) + (31 -1 st pixei (G)) x (EVY /16) 

Dispiay coior (B) = 1 st pixei (B) + (31 - 1 st pixei (B)) x (EVY /16) 

• Computations to decrease brightness 

Dispiay coior (R) = 1 st pixei (R) -1 st pixei (R) x (EVY /16) 

Dispiay coior (G) = 1 st pixei (G) - 1 st pixei (G) x (EVY /16) 

Dispiay coior (B) = 1st pixei (B) - 1st pixei (B) x (EVY /16) 

The computation resuits for brightness are rounded to the nearest integer. 
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6.8 Mosaic 

The Mosaic size is set with the MOSAIC [DB_MOSAIC] Register. Mosaic is turned on/off for each BG with 
the Mosaic Fiag on the BG Controi Register. 

Mosaic Register 

Name Address Attribute Initial Value 

{2D_A) MOSAIC 0x04000040 W 0x0000 

(2D_B) DB_MOSAIC 0x04001040 W 0x0000 


15 

8 

7 

0 

V Size 

H Size 

V Size 

H Size 

OBJ Mosaic Size 

BG Mosaic Size 


The Mosaic Size vaiue specifies how many dots of a normai dispiay shouid comprise each iarge dot 
dispiayed. The Mosaic dispiay starts with the top-ieft dot on the screen and uses the dots spaced a distance 
of the Mosaic size from the top-ieft dot. Aii other dots are overwritten with the mosaic (see Figure 6-43). In 
other words, if the Mosaic size is set to 0, images dispiay normaiiy, even if Mosaic is on. 


Figure 6-43 : Display Changes According to Mosaic Size 
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6.9 Display Priority 

• BG Display Priority 

Four ieveis of dispiay priority can be set for BGs with the BG Controi Register. When BGs have the 
same priority, the one with the iower BG number has higher priority. The Backdrop screen aiways has 
the iowest priority. 

• OBJ Dispiay Priority 

Four ieveis of dispiay priority can be set for OBJs with the OBJ Attribute Data stored in 0AM. When 
OBJs have the same priority, the one with the iower OBJ number has higher priority. 

• BG - OBJ Dispiay Priority 

If an OBJ and a BG have the same priority, the OBJ has higher priority than the BG (see Figure 6-44). 


Figure 6-44 : Display Priority 


Backdrop 


BG 

Priority 3 


BG 

Priority 2 


BG 

Priority 1 


BG 

Priority 0 




Display Priorit 



© 2008-2009 Nintendo 
CONFIDENTIAL 


175 


TWL-06-0017-001-D 
Released: February 16, 2009 



TWL Programming Manual 


TWL-06-0017-001-D 
Released: February 16, 2009 


176 


© 2008-2009 Nintendo 
CONFIDENTIAL 



TWL Programming Manual 


7 3D Graphics 

The TWL 3D graphics engine is unchanged from NITRO except for the fact that known issues in NITRO 
can be corrected with system configuration. For detaiis on the revisions, refer to " 7.2 Geometry Engine " on 
page 182, "7.3 Rendering Engine" on page 251 , and " 2 Differences from NITRO " on page 9. 

Figure 7-1 is a schematic of the hardware biocks invoived in the rendering of 3D graphics. 

Figure 7-1 : 3D Graphics Hardware Biock Diagram 
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• Polygon List RAM, Vertex RAM 

The data that is passed from the Geometry Engine to the Rendering Engine is stored in Polygon List 
RAM and Vertex RAM. 

Table 7-1 shows the capacity for Polygon list RAM and Vertex RAM. 


Table 7-1 : Capacity of Polygon List RAM and Vertex RAM 


RAM 

Capacity 

Polygon List RAM 

2048 polygons 

Vertex RAM 

6144 vertices 


The capacity of polygon list RAM is just enough for 2048 triangular polygons. Because quadrilateral 
polygons have four vertices, fewer of these can be stored in this RAM. A maximum of 1706 can be 
stored for the quadrilateral strip because neighboring quadrilateral polygons share vertices. 

• Buffers inside the Rendering Engine 

The Stencil buffer. Attribute buffer. Depth buffer, and Color buffer are memory regions that store 
information for each pixel. One buffer block in Figure 7-1 depicts a line buffer for an LCD horizontal line 
of 256 pixels. For more details, see the "7.3 Rendering Engine" on page 251 . 
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7.1 3D Display Control 

DISP3DCNT: 3D Display Control Register 

Name: DISP3DCNT Address: 0x04000060 Attribute: RA/V Initial value: 0x0000 



• CIE[d14] : Clear Image enable flag 

Two VRAMs of 128 kilobytes each are used to set the values for Clear Color, Clear a, Clear Depth, 
and Clear Fog. 

The Clear a value is specified with 1 bit, so you can seiect oniy transparent or opaque. 

VRAM2 banks must be assigned to the Ciear Image buffer with the RAM Controi register 0. 

Even when this feature is used, the register vaiue is used for the Ciear Poiygon ID. 

For further information, see "7.3.3.2 Initiaiizina with Ciear Images" on page 257 . 

• GBO[d13] : Polygon List RAM and Vertex RAM overflow flag 

The flag is set to 1 when the Geometry Engine processes too many polygons and vertices and 
Polygon List RAM and Vertex RAM overflow. 

Once an overflow has occurred, the bit remains 1 even if it is no longer overflowing. You can reset the 
flag by writing 1. 


0 

No overflow 

1 

Overflow 


When the polygon list RAM or vertex RAM overflow, the polygon that caused the overflow and all the 
polygons after it are not registered. 

• RBU[d12] : Color buffer underflow flag 

This flag is set to 1 when rendering is not done in time to display and a Color buffer underflow occurs 
(a line overflow in the Rendering Engine). 

Once the Color buffer has underflowed, this bit remains 1 even upon deletion. You can reset by writing 
1. See "7.3.2 Rendering Methods" on page 253 . 


0 

No underflow 

1 

Underflow 
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• [d11-d06] : Fog 

This feature applies a fog effect. For details, see the "7.3.1 Overview" on oaoe 251 . 

• [d11-d08] : Fog Shift 

The depth value used by fog uses the upper 15 bits (called the fog depth value) of the 24 bits. 

The Fog table is referenced using 5 bits of the depth value as an index. 

When the Fog Shift is 0, the bits d14 - d10 of the depth value are referenced as the index. For 
every 1-step increase in the Fog Shift, the reference bits are shifted 1-bit to the right. 

Note: Setting values of 11-15 is prohibited. 

• FME[d07] : Fog master enable flag 


0 

Disable 

1 

Enable 


• FMOD[d06] : Fog mode 

Selecting 1 makes 3D objects appear to dissolve into a 2D background. 


0 

Fog blending using pixel's color value and a value. 

1 

Fog blending using only the pixel's CL value. 


• EME[d05] : Edge-marking enable flag 

This feature draws an outline in the specified color around the edges of polygons with different polygon 
IDs. 

For details, see the "7.3.1 Overview" on page 251 . 


0 

Disable 

1 

Enable 


• AAE[d04] : Anti-aliasing enable flag 

This feature blends the edges of a polygon with the color value for the polygon behind it. 

For details, see the "7.3.1 Overview" on page 251 . 

If you plan to capture the rendering result used as Bitmap OBJ, etc., disabling this flag gives you more 
natural images. 


0 

Disable 

1 

Enable 


• ABE[d03] : Alpha-Blending enable flag 

This feature blends the Color buffer's color with the fragment color in accordance with the fragment's 
alpha value. 

For details, see the "7.3.1 Overview" on page 251 . 


0 

Disable 

1 

Enable 
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• ATE[d02] : a-Test enable flag 

This feature enables you to skip the drawing of pixels that have an a-value lower than the specified 
value. 

For details, see the "7.3.1 Overview" on oaoe 251 . 


0 

Disable 

1 

Enable 


• THS[d01] : Toon/Hlghllght Shading Selection 

This bit selects the shading mode for the polygon specified for Toon shadIng/Hlghllght shading with the 
PolygonAttr command. 

• TMOD : Toon/Hlghllght polygon mode 


0 

Toon shading 

1 

Highlight shading 


• TME[dOO] : Texture Mapping master enable flag 
This selects whether to perform texture mapping. 


0 

Disable 

1 

Enable 
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7.2 Geometry Engine 


In TWL mode, it is possibie to use the revised circuits for the foiiowing features that had probiems on 
NITRO by means of the system configuration. However, in NITRO compatibiiity mode, it wiii be necessary 
to foiiow the notes to work around the probiems. 


Command FIFO : 

Refer to 

1-Dot Polygons : 

Refer to 

Clipping Feature : 

Refer to 

Texture Image Parameters : 

Refer to 

BoxTest: 

Refer to 


" 7.2.6 Geometry Commands " on page 191. 
" 7.2.12 Poivoon Attributes " on page 221. 
" 7.2.13 Poivoons " on page 225. 

" 7.2.14 Texture Mapping " on page 231. 
" 7.2.15 Tests " on page 241. 


7.2.1 Overview 

Tabie 7-2 iists geometry engine specifications. 


Table 7-2 : Geometry Engine Specifications 


Operating Frequency 

33.514MHz 

Coordinate 

Transformation 

Maximum 4 million vertices/sec 

Matrix Computation 

4x4 matrix computation and matrix stack 

Clipping 

6-plane clipping 

Lighting 

Light: Parallel light source x 4 

Material: Reflected light (diffuse reflection, specular reflection, 
ambient reflection). Emission light 

Other features 

Backface culling; Specify display of 1-dot polygons (see note); Box 
culling test; Texture coordinate transformation; Adjust specular 
reflection shininess distribution 


Note: A 1 -dot polygon is a poiygon whose constituent coordinates (x, y) have been condensed to the 
same coordinate. 


7.2.2 Coordinate System 

In three-dimensional space, the coordinate system can be defined in two ways: as a right-handed 
coordinate system or as a left-handed coordinate system, depending on the direction of the z-axis relative 
to the X and y axes. 

As a rule, TWL adopts the right-handed coordinate system. However, because Z values are inverted with 
the projection matrix, the coordinates after clipping are in the left-handed coordinate system. 

Figure 7-2 shows the relation of the x, y, and z axes in a right-handed coordinate system. 

Figure 7-2 : Right-Handed Coordinate System 
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7.2.3 Coordinate Transformations 

In OpenGL, when a model is located in view coordinates, the modei is first muitipiied by the modei view 
matrix, which inciudes the view transformation. This is then muitipiied by the projection matrix, and the 
apparent size of the modei is determined based on the view voiume. 

To reduce the ioad on the hardware, TWL uses a ciip coordinate matrix that is a concatenation of the 
projection matrix and the position coordinates matrix so that ciip coordinate conversion is done with oniy 
one coordinate transformation. Then the ciip coordinate vaiues (x, y, z, w) are divided by 2w (perspective 
division) after oniy the w coordinate is transiated to get the normaiized screen coordinates, and a scaiing 
transformation is done on the BG screen coordinates by a viewport transformation. 

For the vertex's normai vector and iight vector, OpenGL performs a transformation with the transposed 
matrix of the modeiview matrix. In contrast, TWL assumes the vector is normaiized and uses oniy the 
rotationai component's matrix (the orthogonai matrix) for the transformation. This kind of transformation is 
caiied a directional vector transformation. 

In OpenGL, vertex position coordinates and directionai vectors are transformed into view coordinates just 
by setting the modeiview matrix. But in TWL, the vertex position coordinates and directionai vectors are 
transformed by separate matrices, and these are separateiy defined as the position coordinates matrix and 
directional vector matrix. 
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Figure 7-3 illustrates the coordinate transformation flow on the TWL. 

Figure 7-3 : Coordinate Transformation Fiow Chart 
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7.2.4 Projection Transformations 

The perspective of the viewed poiygon object from the eye point is defined by the view voiume. 

The view voiumes and projection matrices for perspective projections (Figure 7-4) and orthogonai 
projections (" Figure 7-5 : Orthogonai Projections " on page 186) are described beiow. 

1. Perspective Projections 


Figure 7-4 : Perspective Projections 

Far Clip Plane 
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b. Left-Right Symmetricai Perspective Projection 
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2. Orthogonal Projections 

Figure 7-5 : Orthogonai Projections 
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t: Top edge y-coordinate of near clip plane 

b : Bottom edge y-coordinate of near ciip piane 

r: Right edge x-coordinate of near ciip piane 

i: Left edge x-coordinate of near ciip piane 

n : Distance from eye point to near ciip piane 

f: Distance from eye point to far ciip piane 

0 : Angie of fieid-of-view (screen angie) in verticai (y) direction 2 

asp : Aspect ratio of width to height of fieid-of-view (height:width ratio = width of fieid-of-view height 
of fieid-of-view) 

scaieW : Parameter for precision-adjusting view voiume 

(Use to change the scaiing of ciip coordinate space and increase the precision of the orthogonai 
screen coordinates after perspective division.) 
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7.2.5 Depth Buffering 

1. For Perspective Projections 

The perspective projection matrix parameters are set as shown beiow. (For detaiis about eiements 
p0-p5, see " 7.2.4 Projection Transformations " on page 185). 


M = 


pO 0 0 0 

0 p2 0 0 

pi p3 p4 -1 
0 0 p5 0 


X scaleW 


When the View coordinates are (x, y, z, 1), the Ciip coordinates (x’, y’, z’, w’) are as foiiows: 

x' = {pQx X + plx z)x scaleW 
y' = (p2xy + p3 X z) X scaleW 
z' = (p4x z +p5 X 1) X scaleW 
w' = -zx scaleW 


When each ciip coordinate component is transiated by w’ and then divided by 2w’ (perspective 
division), the normaiized screen coordinates (x”, y”, z”, 1) are obtained. The z” component is caicuiated 
as foiiows: 


„ _ z' + w' _ (p4 X z + p5 - z) X scaleW 1 p4 p5 

^ 2w' -2zx scaleW 2 2 2z 

p4 and p5 are eiements of the perspective projection matrix, so using the matrix shown in the equation 
" a. Left-Right Asvmmetricai Perspective Projection " on page 185 yieids: 


z" = fl + -1 {-far <z<-near) 

During Z buffering, this z” vaiue is muitipiied by 0x7FFF to get the depth vaiue z’”. The z’” vaiue is 
proportionai to the inverse of the View coordinate z vaiue, so in View coordinate space the position 
coordinates are more precise the cioser they are to the eye point and iess precise the farther they are 
away from the eye point. As a resuit, when you represent a iarge space, drawings that are farther away 
tend to be more imprecise. To resoive this probiem, TWL supports Wbuffering, which uses ciip 
coordination as the depth vaiue. 

Because the depth vaiue is taken as a muitipie of the view coordinate z from the equation... 
w' = -zx scaleW {-far <z^-near) 

... the precision of rendering in the distance improves. The trade-off is that this diminishes the precision 
of nearby images compared to Z-buffering. But by eniarging the view voiume space and adjusting 
scaieW in order to maintain a certain ievei of resoiution, this shouid not present a probiem for nearby 
images. (See Figure 7-6.) 
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Figure 7-6 : Z-Buffering and W-Buffering (Perspective Projection) 




f: Distance from eye point to far ciip piane 
n : Distance from eye point to near ciip piane 
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2. For Orthogonal Projections 

The orthogonal projection matrix parameters are set as shown below. (For details about elements 
p0-p5, see "7.2.4 Projection Transformations " on page 185.) 


M 


X scaleW 


pO 0 0 0 

0 p 2 0 0 

0 0 p4 0 
pi p3 p5 1 

When the View coordinates are (x, y, z, 1), the Clip coordinates (x’, y’, z’, w’) are as follows: 


x' = (pO X X + pi X 1) X scaleW 
y = (p2xy + p3 X 1) X scaleW 
z' = (p4x z+ p5 X 1) X scaleW 
w' = lx scaleW 


When each component of the clip coordinate is translated by w’ and then divided by 2w’ 

When each clip coordinate component is translated by w’ and then divided by 2w’ (perspective 
division), the normalized screen coordinates (x”, y”, z”, 1) are obtained. When scaleW = 1, coordinates 
are translated by 1 and divided by 2, so the clip coordinate system values -1.0 to 1.0 are transformed 
into the normalized screen coordinate system values 0.0 to 1.0. 

The normalized screen coordinate z” component is calculated as follows: 


„ _ z' + w' _ (p4 X z+ p5 + l)x scaleW _ p4 x z + p5 + I 
^ 2w' 2x scaleW 2 

p4 and p5 are elements of the orthogonal projection matrix, so using the matrix shown in the equation 
" 2. Orthogonal Projections " on page 186 yields: 


z" = 77 -^iz + n) {-far <z<-near) 
if-n) 

During Z buffering, this z” value is multiplied by 0x7FFF to get the depth value z’”. This z’” value is 
proportional to the View coordinate z value, so no problems arise with the precision of distant images. 

When w buffering is used, the w’ clip coordinate which serves as the depth value is always fixed to the 
value 1 X scaleW. For this reason, w buffering is not used with orthogonal projections. (See Figure 7-7.) 
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Figure 7-7 : Z-Buffering and W-Buffering (Orthogonal Projection) 
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f: Distance from eye point to far ciip piane 
n : Distance from eye point to near ciip piane 

Depth value format 

The TWL Depth buffer uses 24 bits for each pixei, so the depth vaiue must fit inside that range. 

For Z buffering, the depth vaiue is the vaiue that expresses the distance from the near ciip piane to the far 
ciip piane with 24-bit precision. 

For W buffering, the distance from the eye point in the View coordinate system must fit within the 24-bit 
precision (sign + 11-bit integer -i- 12-bit fractionai part) range of the Ciip coordinate system, and the depth 
vaiue is the resuit of transiating the W vaiue of the ciip coordinates a distance of W and then dividing by 
two (12-bit integer -i- 12-bit fractionai part). 

Note: Make sure that the Ciip coordinate vaiues do not exceed the 24-bit range. 

For fog, the depth vaiue is the upper 15 of the 24 bits. See " 7.3.3.1 Initiaiizing with the Ciear 
Registers " on page 256 for detaiis. 
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7.2.6 Geometry Commands 

To transfer the data of matrices and polygons, etc. to the Geometry Engine requires writing command 
strings to Command FIFO. There are two ways to write to Command FIFO: 

Method 1: Write parameters to the group of command registers mapped in the register space of the main 
processor. 

Write the parameters into Command registers, and the command code and parameters are 
automatically written into Command FIFO. This method works when the CPU will process one 
command at a time. 

Method 2: Write command code and parameters to the Command FIFO register. 

This method is appropriate for transferring large amounts of data to the Geometry Engine, 
such as for DMA transfers of command strings stored in main memory. 

Note: The Geometry Command register group and Command FIFO are specialized for 32-bit access. 
Whether you are writing using the CPU or DMA, make sure the access width is 32 bits. 

When an attempt is made to write to Command FIFO when it is full, the process enters a wait state 
until 32 bits open up in Command FIFO. During this wait state the bus cannot be used even by 
another bus master. You can avoid this situation by doing the following: 

Transfer commands using the DMA Geometry Command FIFO startup mode 

In this mode, DMA is started when Command FIFO becomes less than half full, sending in units of 
112 words (see note) until the specified transfer volume is reached. See "8 DMA" on page 297 . 

Note: If commands have been packed, the word count equals the number of words before 
unpacking. 

You can determine the status of Command FIFO by checking the Command FIFO status 
flag in the Geometry Engine status register (GXSTAT). 
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GXFIFO: Command FIFO Register 

Name: GXFIFO Address: 0x04000400 (Image: 0x04000404 - 0x0400043F) Attribute: W 


31 24 

23 16 

15 8 

7 0 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 



Data written to the Command FIFO register is sent to Command FIFO. 

Command FIFO has a depth of 32 bits x 256 ieveis. 

Be carefui not to transfer undefined command codes. 

Command Packing 

When transferring command strings to the Command FIFO register, the command strings can be 
compressed by packing up to four command codes in one word. 

Packed command strings are first decompressed and then stored in command FIFO. The packed 
command strings are stored in command FIFO in order starting from the iow-order byte, so you need to 
pack the command codes starting from the iow-order address and fiii the empty higher-order bytes with 0. 

Figure 7-8 shows the different command transfers for commands that are packed and not packed. 

Figure 7-8 : Transferring Packed and Non-Packed Commands 
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5 

Parameter B for Command 2 

Parameter for Command 4 

6 

0x00 

0x00 

0x00 

Command 3 

0x00 

0x00 

Command 6 

Command 5 

7 

0x00 

0x00 

0x00 

Command 4 

Parameter for Command 5 

8 

Parameter for Command 4 


9 

0x00 

0x00 

0x00 

Command 5 

/ 1 

/ 1 4-Word Reduction 

/ 1 

10 

Parameter for Command 5 

11 

0x00 

0x00 

0x00 

Command 6 

/ 1 _ 


In the example shown above. Commands 1,4, and 5 have one parameter each. Command 2 has two 
parameters, and Commands 3 and 6 have no parameters. 

In Figure 7-8, a data volume of 11 words is sent to the Command FIFO register when the commands are 
not packed, but when commands are packed only 7 words are sent, for a savings of 4 words. 
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Precautions regarding the CPU continuously writing to the Geometry FIFO 

Continuous writing to the Geometry FIFO using STM or STRD instructions can occur properiy oniy when 
the two foiiowing conditions are met. See Figure 7-9. 

• Command Pack is not used 

• Write oniy one command-parameter pair at a time 

Figure 7-9 : Continuous Writing to the Geometry FIFO Using STM or STRD Instructions 

31 24 23 16 15 8 7 0 


0x000000 

Valid 

Command 

21 h (Normal) 




f 

Parameters for Normal 



Unit that can be 
continuously 
transferred with 
STM or STRD 
instructions 


0x000000 

Valid 

Command 

23h (Vertexi) 

A 




Parameters for Vertexi 



Parameters for Vertexi 


Unit that can be 
continuously 
transferred with 
STM or STRD 
instructions 


0x000000 

Valid 

Command 


41 h (End) 



Unit that can be 
continuously 
transferred with 
STM or STRD 
instructions 


0x000000 

Valid 

Command 

29h (PolygonAttr) 

1 


I 

Parameters for PolygonAttr 

J 


Unit that can be 
continuously 
transferred with 
STM or STRD 
instructions 


The “Unit that can be continuously transferred with STM or STRD instructions” mentioned above can be 
written at a singie time. However, do not perform a write with STM or STRD instructions that exceed this 
unit. Leave a biank intervai of one system cycie between each “Unit that can be continuousiy transferred 
with STM or STRD instructions.” 

Cautions regarding Data Arrays for Command Packs 

Writing to the Geometry FIFO when command packs are used can occur properly only when one of the 
following conditions are met whether using the CPU or DMA. 

• Do not have a command without parameters (see Note 2 below) come in the top level of valid 
commands in the command pack (see Note 1 below). See Figure 7-10 and Figure 7-11 for details. 

Note 1 : Valid command indicates a command defined within the region between 0x10 and Oxff. Invalid 
commands are in the region between 0x00 and OxOf. 
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Note 2: A “command without parameters” is one of the four foiiowing commands: 

• PushMatrix 

• Loadidentity 

• End 

• Commands undefined within the region between 0x10 and Oxff 

Figure 7-10 : Case 1: Preventing a Command Without Parameters from Being the First Vaiid Command 

Top Level of Valid Commands 

31 24 23 I 16 15 8 7 0 


Invalid 

Valid 

Valid 

Valid 

Command 

Command 

Command 

Command 

0x00 

0x41 (End) 

0x23 (Vertexi) 

0x21 (Normal) 


Parameters for Normal 


Parameters for Vertexi 


Parameters for Vertexi 


Valid 

Command 

0x23 (Vertexi) 

Valid 

Command 

0x22 (TexCoord) 

Valid 

Command 

0x40 (Begin) 

Valid 

Command 

0x29 

(PolvaonAttr) 


Parameters for PolygonAttr 



31 24 23 16 15 8 7 


0 


Invalid 

Invalid 

Valid 

Valid 

Command 

Command 

Command 

Command 

0x00 

0x00 

0x23 (Vertexi) 

0x21 (Normal) 


Parameters for Normal 


Parameters for Vertexi 


Parameters for Vertexi 


Valid 

Valid 

Valid 

Valid 

Command 

Command 

Command 

Command 

0x22 (TexCoord) 

0x40 (Begin) 

0x29 (PolygonAttr) 

0x41 (End) 


Parameters for PolygonAttr 
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Figure 7-11 : Case 2: Preventing a Command Without Parameters from Being the First Vaiid Command 

31 24 23 16 15 8 7 0 


Valid 

Valid 

Valid 

Valid 

Command 

Command 

Command 

Command 

0x11 (PushMatrix) 

0x11 (PushMatrix) 

0x11 (PushMatrix) 

0x11 (PushMatrix) 


Valid 

Valid 

Valid 

Valid 

Command 

Command 

Command 

Command 

0x23 (Vertexi) 

0x22 (TexCoord) 

0x40 (Begin) 

0x29 (PolygonAttr) 



Not included in the command pack 

31 24 23 16 15 8 7 0 


Valid 

Valid 

Valid 

Valid 

Command 

Command 

Command 

Command 

0x29 (PolygonAttr) 

0x11 (PushMatrix) 

0x11 (PushMatrix) 

0x11 (PushMatrix) 
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• When a command without parameters comes in the top ievei of vaiid commands in the command 
pack, insert zeros at the end of the parameter array corresponding to that command pack. 

Figure 7-12 : When the First Vaiid Command Has No Parameters 

Top Level of Valid Commands 

31 24 23 I 16 15 8 7 0 


Invalid 

Valid 

Valid 

Valid 

Command 

Command 

Command 

Command 

0x00 

0x41 (End) 

0x23 (Vertexi) 

0x21 (Normal) 



31 24 23 16 15 8 7 0 


Invalid 

Valid 

Valid 

Valid 

Command 

Command 

Command 

Command 

0x00 

0x41 (End) 

0x23 (Vertexi) 

0x21 (Normal) 
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Table 7-3 and Table 7-4 show lists of Geometry Commands. 


Table 7-3 : Geometry Commands (in Command Code Order) 


Category 

Feature 

Command name 

Command 
register 
address 
(see note) 

Command 

code 

No. of 
words in 
parameter 

Page 

— 

No operation 

Nop 

— 

0x00 

0 

None 

Matrix mode 

Sets the matrix mode 

MatrixMode 

0x440 

0x10 

1 

206 

Operations 
on the 
current 
matrix 

Pushes to stack 

PushMatrix 

0x444 

0x11 

0 

211 

Pops from stack 

PopMatrix 

0x448 

0x12 

1 

211 

Writes to specified location in stack 

StoreMatrix 

0x44C 

0x13 

1 

212 

Reads from specified location in 
stack 

RestoreMatrix 

0x450 

0x14 

1 

212 

Initializes a unit matrix 

Identity 

0x454 

0x15 

0 

207 

Sets a 4x4 matrix 

LoadMatrix44 

0x458 

0x16 

16 

207 

Sets a 4x3 matrix 

LoadMatrix43 

0x45C 

0x17 

12 

207 

Multiplies a 4x4 matrix 

MultMatrix44 

0x460 

0x18 

16 

208 

Multiplies a 4x3 matrix 

MultMatrix43 

0x464 

0x19 

12 

208 

Multiplies a 3x3 matrix 

MultMatrix33 

0x468 

0x1 A 

9 

209 

Multiplies a scale matrix 

Scale 

0x46C 

0x1 B 

3 

210 

Multiplies a translation matrix 

Translate 

0x470 

0x1 C 

3 

209 

Vertex 

information 

Directly sets vertex color 

Color 

0x480 

0x20 

1 

226 

Sets normal vector 

Normal 

0x484 

0x21 

1 

227 

Sets texture coordinates 

TexCoord 

0x488 

0x22 

1 

231 

Vertex 

coordinates 

Sets the vertex coordinates 

Vertex 

0x48C 

0x23 

2 

227 

Same as above 

Vertexi 0 

0x490 

0x24 

1 

228 

Sets the XY coordinates of the 
vertex 

VertexXY 

0x494 

0x25 

1 

228 

Sets the XZ coordinates of the 
vertex 

VertexXZ 

0x498 

0x26 

1 

228 

Sets the YZ coordinates of the 
vertex 

VertexYZ 

0x49C 

0x27 

1 

228 

Sets vertex using the differential 
value of the last-set coordinate 

VertexDiff 

0x4A0 

0x28 

1 

229 

Polygon 

attribute 

Sets the polygon attribute 

PolygonAttr 

0x4A4 

0x29 

1 

221 

Texture 

information 

Sets the texture parameters 

TexImageParam 

0x4A8 

0x2A 

1 

232 

Sets the base address of the texture 
palette 

TexPIttBase 

0x4AC 

0x2B 

1 

237 

Material 

Sets the colors for ambient 
reflection and diffuse reflection 

MaterialColorO 

0x4C0 

0x30 

1 

217 

Sets the colors for emission light 
and specular reflection 

MaterialColorl 

0x4C4 

0x31 

1 

217 

Sets the specular reflection 
shininess table 

Shininess 

0x4D0 

0x34 

32 

218 
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Category 

Feature 

Command name 

Command 
register 
address 
(see note) 

Command 

code 

No. of 
words in 
parameter 

Page 

Light 

Sets the directional vector for light 

LightVector 

0x4C8 

0x32 

1 

214 

Sets the light color 

LightColor 

0x4CC 

0x33 

1 

214 

Vertex list 
begin/end 

Declares the start of the vertex list 

Begin 

0x500 

0x40 

1 

225 

Declares the end of the vertex list 

End 

0x504 

0x41 

0 

226 

Swap 

Rendering 

Engine 

reference 

data 

Swaps the data group referenced by 
the Rendering Engine 

SwapBuffers 

0x540 

0x50 

1 

203 

Viewport 

Sets the viewport 

Viewport 

0x580 

0x60 

1 

205 

Test 

Tests whether the box is inside the 
view volume 

BoxTest 

0x5C0 

0x70 

3 

241 

Sets position coordinates for test 

PosItionTest 

0x5C4 

0x71 

2 

243 

Sets directional vector for test 

VectorTest 

0x5C8 

0x72 

1 

243 


Note: The Command register address values shown here are offset from address 0x04000000. 

Be careful not to issue undefined command codes to the Geometry Engine's command FIFO. 
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Table 7-4 : Number of Geometry Command Run Cycles & Timing Related to Command Issue (in Command 

Code Order) 


Command 

Name 

Run 

cycle 

number 

Issue 

timing 

When settings take 
effect 

When settings are destroyed 

Nop 


No 

Restriction 



MatrixMode 

1 

No 

Restriction 

When command is 
executed 

When next MatrixMode command is executed 

PushMatrix 

17 

When next Push/StoreMatrix command is executed 

PopMatrix 

36 

When next Matrix change command is executed 

StoreMatrix 

17 

When next Push/StoreMatrix command is executed 

RestoreMatrix 

36 

When next Matrix change command is executed 

Identity 

19 

LoadMatrix44 

34 

LoadMatrix43 

30 

MultMatrix44 

35*'' 

MultMatrix43 

31*'' 

MultMatrix33 

28*'' 

Scale 

22 

Translate 

22*1 

Color 

1 

When next Color, Normal command is executed 

Normal 

9-12 
(+2)*2. 5 

TexCoord 

1(+1)*5 

When next TexCoord command is executed 

Vertex 

9(-i-2)*5 

Only 

between 

Begin-End 

When next Vertex related command is executed 

VertexShort 

8(-i-2)*5 

VertexXY 

8{+2p 

VertexXZ 

8{+2p 

VertexYZ 

8{+2p 

VertexDIft 

8{+2p 

PolygonAttr 

1 

Only 

outside 

Begin - 
End 

When Begin command 
is executed (settings 
are valid between 

Begin-End units) 

When next PolygonAttr command is executed 

TexImageParam 

1 

Per 

Polygon*"' 

When command is 
executed (settings are 
valid in polygon units) 

When next TexImageParam command is executed 

TexPIttBase 

1 

When next TexPIttBase command is executed 
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Command 

Name 

Run 

cycle 

number 

Issue 

timing 

When settings take 
effect 

When settings are destroyed 

MaterialColorO 

4 

No 

Restriction 

When Normal 
command Is executed 

When next MaterialColorO command Is executed 

MaterialColorl 

4 

When next MaterialColorl command Is executed 

Shininess 

32 

When next ShInIness command Is executed 

LightVector 

6 

When next LightVector command Is executed 

LightColor 

1 

When next LightColor command Is executed 

Begin 

1 

When command Is 
executed 

When next Begin command is executed 

End 

1 

No set value 

SwapBuffers 

392 

Only 

outside 

Begin - 
End 

When enter V-Blank 
period 

When next SwapBuffers command Is executed 

Viewport 

1 

When command Is 
executed 

When next VIewPort command is executed 

BoxTest 

103 

When next BoxTest command is executed 

PositionTest 

9 

Per 

Polygon*"^ 

When next PositionTest is executed 

VectorTest 

5 

No 

Restriction 

When next VectorTest is executed 


The number of run cycles is a system clock (33.514MHz) converted value, and is the minimum vaiue. Extra 
cycies wiii be required if access coiiisions, dipping, pipeiine hazards, or other compiications occur. 

When in Position and Vector Simuitaneous Setting mode, this takes another 30 cycies. 

Is increased according to the number of iights that are enabied (ON) 

The PoiygonAttr command is enabied with the Begin command. However, to refiect the iight enabie fiag 
on vertex coior, issue a Normai command again to recaicuiate the iighting. 

Concerning the Poiygon unit: 

Commands that can be issued in poiygon units can be issued in the Vertex-reiated command string at 
poiygon breakpoints (breakpoints appear as • in the foiiowing tabie.) 
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Triangular Polygons 

Begin 

Vertex //Polygon 1 

Vertex 

Vertex 

• 

Vertex //Polygon 2 

Vertex 

Vertex 

• 

Vertex //Polygon 3 

Vertex 

Vertex 

End 


Triangular Polygon Strip 


Begin 

• 

Vertex //Polygon 1 

Vertex 

Vertex 

Vertex 

Vertex //Polygon 2 
Vertex //Polygon 3 

• 

End 


Quadrilateral Polygons 


Begin 

• 

Vertex //Polygon 1 

Vertex 

Vertex 

Vertex 

• 

Vertex //Polygon 2 

Vertex 

Vertex 

Vertex 

• 

Vertex //Polygon 3 

Vertex 

Vertex 

Vertex 

• 

End 


Quadrilateral Polygon Strip 


Begin 

• 

Vertex //Polygon 1 

Vertex 

Vertex 

Vertex 

Vertex //Polygon 2 
Vertex 

Vertex //Polygon 3 
Vertex 

• 

End 


* ^ The number of run cycles for commands corresponding to each source increases by the amount shown 
in parentheses when performing texture coordinate conversion in texture coordinate conversion mode. 
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Figure 7-13 shows a schematic of the main Geometry Command processes. 


Figure 7-13 : Schematic of the Main Geometry Command Processes 



Note: The fiow shown here for the TexCoord command is for when the texture coordinate transformation 
mode is set to TexCoord source. 
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7.2.7 Swapping the Rendering Engine's Reference Data 

SwapBuffers: Swaps the Data Group referenced by the Rendering Engine 

Name: SWAP BUFFERS Address: 0x04000540 Attribute: W Cemmand Code: 0x50 



• DP[d01] : Depth buffering selection flag 

Selects the value used for the depth test. To read how the depth value differs depending on the depth- 
buffering method, see "7.2.5 Depth Buffering" on page 187 . 


0 

Select buffering with the Z value 

1 

Select buffering with the W value 

(Does not function properly for orthogonal projections) 


• YS[d00] : Translucent polygon Y-sorting selection flag 

Translucent polygons are polygons with (1 < a < 30) or mapped with a translucent texture. 
Select manual sort mode to specify the order of rendering, such as when using shadow volume. 


0 

Auto-sort mode 

1 

Manual sort mode 


The Geometry Engine writes the data passed to the Rendering Engine to Polygon List RAM. 

For translucent polygons, you can choose whether to sort the data and then write, or to write the data 
in the order the polygons are processed without sorting. In Auto-sort mode, polygons are sorted from 
the polygon with smallest maximum Y value on the LCD (see note) to the polygon with the largest 
maximum Y value. Polygons that share the same maximum Y value are sorted in order from the 
polygon with smallest minimum Y value. 

In Manual sort mode, polygons are sorted according to the order in which they are sent to the 
Geometry Engine. 

In Auto sort mode, the Rendering Engine does not reference polygons with minimum Y values larger 
than the scan line (a line that is being rendered) or polygons with maximum Y values smaller than the 
scan line. However, all polygons are referenced in manual mode, which increases the load on the 
geometry engine (and reduces rendering efficiency). Because of this, be careful when using Manual 
sort mode when there are a large number of translucent polygons. 

Opaque polygons are always Auto sorted. 

Regardless of the sort mode, opaque polygons are always rendered before translucent polygons. 

Note: Maximum Polygon Y value on the LCD 

The Y coordinates are the inverse of Y coordinates in the BG Screen Coordinate Group in the 
Coordinate Transformation Flow Chart (Figure 7-3). Therefore, the maximum Y value for a 
polygon on the LCD is the minimum value in the BG Screen Coordinate Group. 
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• Reflecting the Depth Buffering Seiect Fiag and Transiucent Poiygon Y Sorting Seiect Fiag 

These fiags are refiected in the geometry engine from the next frame. Flowever, because poiygon iist 
RAM and vertex RAM are doubie buffered, the rendering engine renders the data that the geometry 
engine stored in the previous frame. Therefore, data that the geometry engine outputs is rendered with 
an additionai one-frame deiay. 

• Processing the SwapBuffers command 

The SwapBuffers command is processed at the next V-Biank, regardiess of when it was input. (The 
geometry engine is in wait status untii the V-Biank period arrives.) The Poiygon List RAM, Vertex RAM, 
rendering-reiated registers, and other data referenced by the Rendering Engine is swapped at the start 
of the next V-Biank period after the issuance of the SwapBuffers command. Because of this timing, 
rendering refiects the written graphics data in the next frame after the SwapBuffers command is 
issued. 
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7.2.8 Viewport 


Viewport: Sets the Viewport 

Name: VIEWPORT Address: 0x04000580 Attribute: W Command Code: 0x60 


31 24 

23 16 

15 8 

7 0 

INTEGER_Y2 

INTEGER_X2 

INTEGER_Y1 

INTEGER_X1 

Y2 

X2 

Y1 

XI 


• Y2, X2 [d31-d24, d23-d16] : Top right coordinates 

Set Y2 to a vaiue iarger than Y1. Can be set in the range 0-191. 

Set X2 to a vaiue iarger than XI. Can be set in the range 0-255. 

• Y1, XI [d15-d08, d07-d00] : Bottom ieft coordinates (the viewport origin) 

Set Y1 to a vaiue smaiier than Y2. Can be set in the range 0-191. 

Set XI to a vaiue smaiier than X2. Can be set in the range 0-255. 

This sets the position and the size of the viewport which draws 3D graphics on the BGO screen. 
The BGO's H offset is added to get the dispiay position on the LCD. 

Notice that the origin point is different than for the 2D coordinate group. (See Figure 7-14) 

Figure 7-14 : Size and Position of the Viewport 

BGO Screen 



Origin-Viewport X Axis ->• 

0 255 


Note: Rendering may resuit in one dot protruding from the right or bottom edge of the viewport. 
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7.2.9 Matrices 

7.2.9.1 Manipulating the Current Matrix 

MatrixMode: Sets the Matrix Mode 

Name: MTX MODE Address: 0x04000440 Attribute: W Command Code: 0x10 



Matrix Mode 


• M[d01-d00] : Matrix mode 


... (For manipulating projection matrices) 

... (For manipulating position coordinate matrices) 

... (For manipulating position coordinate matrices and 
directional vector matrices) 

... (For manipulating texture matrices) 

This specifies the current matrix on which Matrix commands operate (this ciassification is caiied the 
matrix mode). 

Position mode and Position and Vector Simultaneous Set mode 

TWL does not use the hardware to make a unit normai vector. Therefore, to obtain correct lighting effects, 
you must set a unit vector as the normal in advance, and the directional vector matrix must be an 
orthogonal matrix (a matrix that does not change the length of the directional vector). When a model is 
transformed, the transformation matrix is usually used for both the position coordinates matrix and the 
directional vector matrix. But with TWL, the directional vector matrix must be maintained as an orthogonal 
matrix, so depending on the type of transformation, sometimes the transformation matrix is used only for 
the position coordinates matrix. 

Let the situation dictate whether to use Position mode or Position and Vector Simultaneous Set mode to 
set the Position and Vector simultaneously. 

Examples 

When rotating a model, usually the mode is set to the Position and Vector Simultaneous Setting and the 
MultMatrix command is executed to apply the rotation component of the matrix for both the position 
coordinates matrix and the directional vector matrix. 

When the Scale command is used for model scaling, the directional vector matrix can be maintained as an 
orthogonal matrix, so the correct lighting effect can be obtained. (See the Scale command on page 210 .) 

When the scale matrix is applied with the MultMatrix command, the directional vector matrix is not 
maintained as an orthogonal matrix, and the lighting effect is brighter or darker than the original. Thus, it 
would be safer not to use this procedure. 

When Position mode is selected. Matrix commands are applied only to the position coordinates matrix, so 
the correct lighting effect is obtained even when the scale matrix is applied with the MultMatrix command. 
You can also use this mode when you want to apply the rotation matrix only to the position coordinates 
matrix, but unnatural effects can arise. For example, sometimes the lighting effect does not change upon 
rotation, or a part that is not being illuminated ends up being the brightest. 


00 

Projection mode 

01 

Position mode 

10 

Position & Vector 
Simultaneous Set mode 

11 

Texture mode 
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MTXJDENTITY: Initialize Current Matrix to Unit Matrix 

Name: MTX IDENTITY Address: 0x04000454 Attribute: W Command Code: 0x15 


31 24 

23 16 

15 8 

7 0 


































































LoadMatrix44: Set 4x4 Matrix to Current Matrix 

Name: MTX LOAD 4x4 Address: 0x04000458 Attribute: W Command Code: 0x16 


31 30_24123_leJiS_12 11_ sJt_0 


n 

INTEGER_M44 

DECIMAL_M44 


Integer part 

Decimal part 


Signed fixed-point number (sign -i- 19-bit integer -i- 12-bit fractionai part) 
• M44 : 4x4 matrix eiements m[x] (x = 0 - 15) 

The matrix M is set as foiiows with eiements m[0] to m[15]: 


m[0] 

m[l] 

m[2] 

m[3] 

m[4] 

m[5] 

m[6] 

m[7] 

m[8] 

m[9] 

m[10] 

m[ll] 

m[12] 

m[13] 

m[14] 

m[15] 


LoadMatrix43: Set 4x3 Matrix to Current Matrix 

Name: MTX LOAD 4x3 Address: 0x0400045C Attribute: W Command Code: 0x17 


31 30_24123_leJiS_12 11_ sJt_0 


n 

INTEGER_M43 

DECIMAL_M43 


Integer part 

Decimal part 


Signed fixed-point number (sign -i- 19-bit integer -i- 12-bit fractionai part) 
• M43 : 4x3 matrix eiements m[x] (x = 0 - 11) 

The matrix M is set as foiiows with eiements m[0] to m[11]: 


m[0] 

m[l] 

m[2] 

0 

m[3] 

m[4] 

m[5] 

0 

m[6] 

m[7] 

m[8] 

0 

m[9] 

m[10] 

m[ll] 

1 
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MultMatrix44: Multiply 4x4 Matrix by Current Matrix 

Name: MTX MULT 4x4 Address: 0x04000460 Attribute: W Command Code: 0x18 


31 30_24123_leJiS_12 11_ sJt_0 


B 

INTEGER_M44 

DECIMAL_M44 


Integer part 

Decimal part 


Signed fixed-point number (sign + 19-bit integer -i- 12-bit fractionai part) 
• M44 : 4x4 matrix eiements m[x] (x = 0 -15) 

The matrix M is set as foiiows with eiements m[0] to m[15]: 


m[0] 

m[l] 

m[2] 

m[3] 

m[4] 

m[5] 

m[6] 

m[7] 

m[8] 

m[9] 

m[10] 

m[ll] 

m[12] 

m[13] 

m[14] 

m[15] 


If the current matrix is C, then the new current matrix C’ = MC 

MultMatrix43: Multiply 4x3 Matrix by Current Matrix 

Name: MTX MULT 4x3 Address: 0x04000464 Attribute: W Command Code: 0x19 


31 30_24123_ leJlS _12 11_sJt_0 


B 

INTEGER_M43 

DECIMAL_M43 


Integer part 

Decimal part 


Signed fixed-point number (sign -i- 19-bit integer -i- 12-bit fractionai part) 
• M43 : 4x3 matrix eiements m[x] (x = 0-11) 

The matrix M is set as foiiows with eiements m[0] to m[11]: 


m[0] 

m[l] 

m[2] 

0 

m[3] 

m[4] 

m[5] 

0 

m[6] 

m[7] 

m[8] 

0 

m[9] 

m[10] 

m[ll] 

1 


If the current matrix is C, then the new current matrix C’ = MC 
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MultMatrix33: Multiply 3x3 Matrix by Current Matrix 

Name: MTX MULT 3x3 Address: 0x04000468 Attribute: W Command Code: 0x1 A 


31 30_24123_leJlS_12 11_ sJt_0 


u 

INTEGER_M33 

DECIMAL_M33 


Integer part 

Decimal part 


Signed fixed-point number (sign -i- 19-bit integer -i- 12-bit fractionai part) 

• M33 : 3x3 matrix eiements m[x] ( x = 0 - 8) 

The matrix M is set as foiiows with eiements m[0] to m[8]: 

m[0] m[l] m[2] 0 

_ m[3] m[4] m[5] 0 

m[6] m[7] m[8] 0 

0 0 0 1 

If the current matrix is C, then the new current matrix C’ = MC 

Translate: Multiply Translation Matrix by Current Matrix 

Name: MTX TRANS Address: 0x04000470 Attribute: W Command Code: 0x1 C 


31 30_24123_leJlS_12 11_ sJt_0 



INTEGER_TRANSLATE 

DECIMAL_TRANSLATE 


Integer part 

Decimal part 


Signed fixed-point number (sign -i- 19-bit integer -i- 12-bit fractionai part) 
• TRANSLATE : Transiation matrix eiements m[x] ( x = 0 - 2) 

The matrix M is set as foiiows with eiements m[0] to m[2]: 


10 0 0 
M= 0 1 0 0 

0 0 10 

_m[0] m[l] m[2] 1 

If the current matrix is C, then the new current matrix C’ = MC 
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Scale: Multiply the Scale Matrix by Current Matrix 

Name: MTX SCALE Address: 0x0400046C Attribute: W Cemmand Code: 0x1 B 


31 30_24123_leJiS_12 11_ sJt_0 


s 

INTEGER_SCALE 

DECIMAL_SCALE 

Sign 

Integer part 

Decimal part 


Signed fixed-point number (sign -i- 19-bit integer -i- 12-bit fractionai part) 
• SCALE : Scaie matrix eiements m[x] ( x = 0 - 2) 

The matrix M is set as foiiows with eiements m[0] to m[2]: 


m[0] 0 0 0 

^ ^ 0 m[l] 0 0 

0 0 m[2] 0 

_ 0 0 0 1 _ 

If the current matrix is C, then the new current matrix C’ = MC 


The Scaie command performs muitipiication oniy on the position coordinates matrix, even when the 
matrix mode has been set to Position & Vector Simuitaneous Setting mode. (If it were performed on 
the directionai vector matrix, the direction and iength of vectors wouid change and abnormai iighting 
effects wouid arise.) 
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7.2.9.2 Matrix Stack 

Manipulations are made to the stack of the current matrix. 

Because the position coordination matrix stack and the directionai vector matrix stack are connected, 
manipuiations affect both stacks, whether the mode is set to Position mode or Position & Vector 
Simuitaneous Setting mode. 

PushMatrix: Push the Current Matrix on the Stack 

Name: MIX PUSH Address: 0x04000444 Attribute: W Command Code: 0x11 


31 24 

23 16 

15 8 

7 0 


































































PopMatrix: Pop the Current Matrix from the Stack 

Name: MIX POP Address: 0x04000448 Attribute: W Command Code: 0x12 



Signed integer (sign + 5-bit integer) 

• NUM[d05-d00] : Specify the number of pops (Can set a vaiue of -30 to 31) 

Pops the n**^ ievei matrix (as specified by NUM), starting from the position of the stack pointer of the 
matrix stack specified by the matrix mode, and sets it as the current matrix. 

When the matrix mode is set to projection mode, the stack oniy has 1 ievei so the vaiue of NUM is 
treated as 1, no matter what vaiue has been set. 

This command is normaiiy issued outside of the command string that runs from Begin to End, but it can 
aiso be issued between Vertex commands within the Begin to End command string. 


Command String 
Example 1 

PushMatrlx^Translate^Begln^Vertex^Vertex^Vertex^End^PopMatrix (1) 

Command String 
Example 2 

PushMatrix^Translate^PushMatrlx^Begln^Vertex^PopMatrix (l)^Vertex^ 
PopMatrix (-l)^Vertex^PopMatrix (l)^Vertex^End^PopMatrix (1) 


In Command string Exampie 2, the PopMatrix command is issued between Vertex commands to 
reaiize stitching and sprite poiygon deformations. Stitching is a type of skinning. Sprite poiygons are 
poiygons dispiayed in 2D. 
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StoreMatrix: Store the Current Matrix in the Specified Stack Position 

Name: MTX STORE Address: 0x04000440 Attribute: W Command Code: 0x13 


31 24 

23 16 

15 8 

7 4 0 





























INDEX 





























Storage Position 


Unsigned integer (5-bit integer) 

• INDEX[d04-d00] : Storage position (Can set a vaiue of 0 to 30) 

Stores the matrix specified with matrix mode in the matrix stack in the position specified by INDEX. 

When the matrix mode is set to projection mode, the stack oniy has 1 ievei so the vaiue of INDEX is 
treated as 0 no matter what vaiue has been set. 

The matrix stack pointer moved by the PushMatrix and PopMatrix commands does not move after this 
command is issued. 

RestoreMatrix: Reads Matrix from Specified Position in Stack 

Name: MTX RESTORE Address: 0x04000450 Attribute: W Cemmand Code: 0x14 


31 24 

23 16 

15 8 

7 5 4 0 




























INDEX 




























Read Position 


Unsigned integer (5-bit integer) 

• INDEX[d04-d00] : Read position (Can set a vaiue of 0 to 30) 

The vaiue in the position specified by INDEX in the matrix stack is set as the matrix specified by the 
matrix mode. 

When the matrix mode is set to projection mode, the stack oniy has 1 ievei so the vaiue of INDEX is 
treated as 0 no matter what vaiue has been set. 

The matrix stack pointer moved by the PushMatrix and PopMatrix commands does not move after this 
command is issued. 

This command is normaiiy issued outside of the command string that runs from Begin to End, but it can 
aiso be issued between Vertex commands within the Begin to End command string. 


Command String 
Example 1 

StoreMatrix (i)^Translate^Begin^Vertex^Vertex^Vertex^End^ RestoreMatrix (i) 

Command String 
Example 2 

StoreMatrix (i)^Translate^StoreMatrix (i+1)^Begin^Vertex^RestoreMatrix (i)^ 
Vertex^RestoreMatrix (i+1)^Vertex^End^RestoreMatrix (i) 


In Command string Exampie 2, the RestoreMatrix command is issued between Vertex commands to 
reaiize stitching and sprite poiygon deformations. Stitching is a type of skinning. Sprite poiygons are 
poiygons dispiayed in 2D. 
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7.2.9.3 Reading the Current Matrix 

CiipMatrix_Resuit: Read the Current Ciip Coordinates Matrix 


CLIPMTX_RESULT_x (x=0-15) 


Address 

0x04000640,0x04000644, 0x04000648, 0x0400064C, 
0x04000650,0x04000654, 0x04000658, 0x0400065C, 
0x04000660,0x04000664,0x04000668, 0x0400066C, 
0x04000670,0x04000674, 0x04000678, 0x0400067C 


Attribute Initial Value 


0x00000000 


INTEGER_m[x] 

DECIMAL_m[x] 

Integer part 

Decimal part 


Signed fixed-point number (sign -i- 19-bit integer -i- 12-bit fractionai part) 
m[x] (x = 0-15) : The eiements of the current ciip coordinates matrix 


m[0] 

m[l] 

m[2] 

m[3] 

m[4] 

m[5] 

m[6] 

m[7] 

m[8] 

m[9] 

m[10] 

m[ll] 


[m[12] m[13] m[14] m[15]J 

The current ciip coordinates matrix (position coordinate matrix and projection matrix) can be read. 

If you want to read the current projection matrix, make the current position coordinates matrix a unit 
matrix and read this register. 

If you want to read the current position coordinates matrix, make the current projection matrix a unit 
matrix and read this register. 

Note: To safeiy read these matrices, confirmation that the Geometry Engine is stopped must occur 
before reading. 

VectorMatrix: Read the Current Directional Vector Matrix 


Name Address 


0x04000680,0x04000684, 0x04000688, 0x04000680, 
VECMTX_RESULT_x (x =0-8) 0x04000690, 0x04000694, 0x04000698, 0x04000690, 

0X040006A0 


Attribute Initial Value 


0x00000000 


INTEGER_m[x] 

DECIMAL_m[x] 

Integer part 

Decimal part 


Signed fixed-point number (sign -i- 19-bit integer -i- 12-bit fractionai part) 

• m[x] (x = 0 - 8) : The eiements of the current directionai vector matrix 

m[0] m[l] m[2] 

CurrentDirectionalVectorMatrix = ^[3] m[4] m[5] 

_m[6] m[7] m[8]_ 

Note: To safeiy read this matrix, first confirm that the Geometry Engine is stopped. 
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7.2.10 Light 

TWL supports only parallel light sources. 

LightVector: Set the Light's Directional Vector 

Name: LIGHT VECTOR Address: 0x040004C8 Attribute: W Command Code: 0x32 


31 30 29 28_24123_20 19 18 16|l5_10 9 8 | 7_0 


LNUM 

SZ 

DECIMAL.Z 

SY 

DECIMAL.Y 

SX 

DECIMAL_X 

Light 

Directional vector's Z component 

Directional vector's Y component 

Directional vector's X component 


Signed fixed-point number (sign -i- 9-bit fractionai part) 

• LNUM[d31-d30] : Light number 
0-3 

• X, Y, Z[d29-d20], [d19-d10], [d09-d00] : Directionai vector 

Coordinate transformation with the directionai vector matrix is performed after the settings are made. 
The hardware does not perform vector normaiization, so set the unit vector. 

LightColor: Set the Light Color 

Name: LIGHT COLOR Address: 0x040004CC Attribute: W Command Code: 0x33 



• LNUM[d31-d30] : Light number 
0-3 

• [d14-d00] : Light coior 

Aithough OpenGL has iight coior parameters for diffuse, specuiar, and ambient iight, for TWL this has 
been simpiified to a singie parameter. 
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7.2.11 Material 

For objects, the appearance of the texture differs depending on the materiai on the surface of the object 
and the environment in which the object sits. 

As shown in Figure 7-15, iighting (the iiiumination process) uses four materiai coiors (specuiar refiection coior, 
diffuse refiection coior, ambient refiection coior, and emission iight coior) to express the texture of a modei. 

Figure 7-15 : Material Color Schematic 


Light 

Source 



SPECULAR: Specular 
Reflection Color 



DIFFUSE: Diffuse 
Reflection Color 


AMBIENT: Ambient 
Reflection Color 


EMISSION: Emission Light Color 


Diffuse reflection color 

This is the color of the object when it is illuminated by the light. Consider this the basic color of the object. 

The diffuse reflection color is defined to reflect evenly in all directions, so it is not influenced by the position 
of the eye point. As shown in Figure 7-16, it is, however, influenced by the color and the direction of the 
light and by the normal of the polygon. 

The only influence it has is on the color of the parts of objects that are directly illuminated by the light. 

Figure 7-16 : Directional Vector Relational Diagram (Diffuse Reflection Color) 


Light 

Source 



Light Vector ^ 
L 


Normal vector N: The unit normal vector of the vertex. (Set with the Normal command) 

Light vector L: Normalized vector of parallel light source. (Set with the LightVector command) 
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Ambient reflection color 

This is the coior of the object when it is iiiuminated by ambient iight. 

Objects are iiiuminated not oniy by direct iight, but aiso by iight refiecting off of other objects. 

This refiected iight is caiied ambient iight when it is defined to exist uniformiy in the entire scene. Since 
ambient iight exists uniformiy in the entire scene, it infiuences the coior of the entire object. 

Diffuse refiection coior has strong infiuence of parts of the object that are iiiuminated by direct iight, but 
ambient refiection coior has the predominant infiuence on parts that are shaded. 

Specular reflection color 

This is the giossy coior of the object when it is iiiuminated by iight. This giossiness is caiied specuiar highiight. 

in opticai terms, specuiar highiight is the refiected iight of the iight source. Accordingiy, the part of the 
object where iight strikes and refiects straight back to the eye point is the brightest. 

Specuiar highiight is infiuenced by the coior and direction of iight, the normai of the poiygon and the 
position of the eye point. (See Figure 7-17.) 

When the eye point shifts the specuiar highiight moves. 

it oniy has infiuence on the coior of the parts of objects that are directiy iiiuminated by the iight, and this 
infiuence corresponds to the eye point. 

Figure 7-17 : Directional Vector Relational Diagram (Specular Reflection Color) 


Light 

Source 



Normal Vector N 



Half-Angle Vector H of L and E 

Normal vector N: The unit normai vector for the vertex. (Set with the Normai command.) 

Line-of-sight vector E: Normaiized vector from eye point toward vertex. Taken to be the same as the 
negative direction of the z axis in the View coordinate system. 

Light vector L: Normaiized vector of paraiiei iight source. (Set with the LightVector command.) 

Half-angle vector H of L and E: Normaiized vector of the sum of the iine-of-sight vector and the iight vector. 

When TWL performs the caicuiation for specuiar refiection shininess, the iine-of-sight vector is taken to be 
the same as the negative direction of the z axis in the View coordinate system, and it is assumed that both 
the iight vector and the normai vector wiii be transformed into the View coordinate system. 
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For this reason, when the View matrix (the LookAt matrix) is appiied to the projection matrix, the coordinate 
system for the iight vector and normai vector differ from the coordinate system for the iine-of-sight vector 
after the transformation, and the specuiar refiection resuit is abnormai. 

Accordingiy, when the specuiar refiection coior is set to any vaiue other than biack (0), the matrix mode 
must be set to the Position & Vector Simuitaneous Set mode, and the rotation component of the view 
matrix (the LookAt matrix) must be refiected on the directionai vector matrix. 

When the specuiar refiection coior is set to biack, the view matrix can be appiied to the projection matrix 
because diffusion refiection does not depend on the eye point. In short, you can set the modei matrix for 
the position coordinates matrix, and the combination of the view matrix and the projection matrix for the 
projection matrix. 

Emission light color 

This is the coior of the iight that is emitted from the object itseif. 

Note that this is not treated as iight, so it does not iiiuminate other objects (that is, it does not infiuence the 
coior of other objects). 

To achieve this resuit, you need to create a iight source that is the same coior as the emission iight coior 
and piace it at the same position as the object that you want emitting iight. 

MaterialColorO: Set the Material's Diffuse Reflection Color and Ambient Reflection Color 

Name: DIF AMB Address: 0x040004C0 Attribute: W Command Code: 0x30 


31 30 


26 25 24 23 


21 20 


16 15 14 


10 9 8 7 


5 4 



AMBIENT_BLUE 

AMBIENT_GREEN 

AMBIENT_RED 

B 

DIFFUSE.BLUE 

DIFFUSE_GREEN 

DIFFUSE_RED 


Ambient reflection color 

□ 

Diffuse reflection color 


Vertex 


C[d15]: Vertex color set flag 


0 

Does not set vertex color 

1 

Sets the diffuse reflection color as the vertex color 


If diffuse reflection color has been set for the vertex color, it remains valid until the next time the Color, 
Normal or MaterialColorO (vertex color set flag) command is issued and the current vertex color is updated. 

Because the vertex color is handled as bits R:G:B = 6:6:6 in the Rendering Engine, the diffuse reflection 
color is applied to the upper five bits. When diffuse reflection color is 0, the lower 1 bit is 0, and when the 
diffuse reflection color is nonzero, the lower 1 bit is 1. 


MaterialColorl: Set the Material's Specular Reflection Color and Emission Color 

Name: SPE EMI Address: 0x040004C4 Attribute: W Cemmand Code: 0x31 


31 30 


26 25 24 23 


21 20 


16 15 14 


10 9 8 7 


5 4 



EMISSION.BLUE 

EMISSION_GREEN 

EMISSION_RED 

S 

SPECULAR_BLUE 

SPECULAR_GREEN 

SPECULAR_RED 


Emission color 


Specular reflection color 


Shininess 


S[d15] : Specular reflection shininess table - enable flag 


0 

Disable 

1 

Enable 
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Shininess: Set the Specuiar Refiection Shininess Tabie 

Name: SHININESS Address: 0x0400004D Attribute: W Command Code: 0x34 


31 24 

23 16 

15 8 

7 0 

SHININESS.n (n=4x+3) 

SHININESS n (n=4x+2) 

SHININESS.n (n=4x+1) 

SHININESS n (n=4x+0) 

Shininess when ls=n 

Shininess when ls=n 

Shininess when ls=n 

Shininess when ls=n 


Unsigned fixed point decimai (8-bit fractionai part) 

Sets the 8-bit x 128 tabie for converting the shininess of the specuiar refiection. 

If the specular reflection shininess table-enable flag was set to 1 by the just-issued MaterialColorl 
command, the Geometry Engine looks up the table based on the upper 7 bits of Is —the result of the 
specular calculation—and converts the shininess of the specular reflection. 

This table can be used to adjust the brightness of the specular reflection. (See "7.2.11.1 Lighting 
(Illumination Process)" on page 219 for the computation formula.) 

By rewriting the specular reflection shininess table, you can display polygons having a number of different 
specular reflection effects inside a single scene. 

The specular reflection shininess calculation result Is is obtained from the inner product of the vectors, so 
as Figure 7-18 shows, it is less precise near the center of the luster and more precise farther away (A-B = 
|A| |B|cos0). (See "7.2.11.1 Lighting (Illumination Procession page 219 for the /s calculation.) 

Figure 7-18 : Specular Reflection Shininess 

cos 0 



Technique 

You can achieve special lighting effects by setting non-consecutive values for the specular reflection 
shininess table. 
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7.2.11.1 Lighting (liiumination Process) 

Lighting (the iiiumination process) is conducted when the Normai command is issued, and the resuits of 
the caicuiations are used for the vertex coior. 

The computations shown beiow are done on each coior component (R, G, B). 


Lighting Formuias for Various Materiai Coiors 


Material Color 

Lighting Formuias 

Diffuse Reflection Color 

Id = max[ 0, -L*N ] 

D = ld*llght*diffuse_materlal 

Ambient Reflection Color 

A = llght*amblent_materlal 


Is = max[ 0, cos 2 0] 

Specular Reflection Color 

(When the specular reflection shininess table Is disabled) 

S = ls*llght*specular_materlal 


(When the specular reflection shininess table Is enabled) 

S = shininess_table[ Is ]*llght*specular_materlal 

Emission Color 

E = emlssion_materlal 


L : The iight's directionai vector 
N : Normai vector 

H : The vector that is haif the sum of L (the iight's directionai vector) and the iine-of-sight vector (the vector 
that points in the negative direction of the Z axis.) This is caiied a half-angle vector because it indicates the 
direction haifway between the L and iine-of-sight vectors. 

0 : The angie between the vector (-H) and the vector (N) 

id : Diffuse refiection shininess 

is : Specuiar refiection shininess 

iight: Light coior 

diffuse_materiai: Materiai's diffuse refiection coior 
ambient_materiai : Materiai's ambient refiection coior 
specuiar_materiai : Materiai's specuiar refiection coior 
emission materiai ; Materiai's emission coior 
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Vertex color expressions 

The ultimate vertex color is caicuiated with the foiiowing expression using the resuits of the iighting 
caicuiations conducted on each materiai coior. 

3 

C = ^ [Di + A / + Si] + E 

i = 0 

C: Vertex coior 

Di : Diffuse refiection coior for iight / 

Ai : Ambient refiection coior for iight / 

Si ; Specuiar refiection coior for iight / 

E : The coior of seif-emitted iight 

When iight / is disabied, the corresponding coior components (Di, Ai, Si) are not caicuiated. 

The greater the number of iights that are enabied, the greater the ioad of the vertex coior computations 
(that is, the greater the ioad of the Normai command). For this reason, be carefui not to enabie any more 
iights than are needed. 

Vertex color when lighting is OFF 

Even when iighting is OFF, the vertex coior is caicuiated using the above expressions when the Normai 
command is issued. The resuit in this case is that the vertex coior is set to the emission coior. 
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7.2.12 Polygon Attributes 

PolygonAttr: Set the Polygon-Related Attribute Values 

Name: POLYGON ATTR Address: 0x040004A4 Attribute: W Command Code: 0x29 



• [d29-d24] : Polygon ID 

The polygon ID Is stored In separate attribute buffers for opaque polygons and translucent polygons 
when the polygon Is being rendered by the Rendering Engine. The stored polygon ID Is used when 
rendering translucent polygons and shadow polygons and when edge-marking. For details, see "7.3.4 
Rasterizing" on page 260 . 

• [d20-d16] : alpha value 


1-31 

Polygon's opaqueness 

0 

Wire frame display 


The polygon Is called a translucent polygon when 1 < a < 30 and an opaque polygon when a = 31. 
When a = 0, the display becomes a wireframe display and the original meaning of a Is lost. 

• FE[d15] : Fog-enable flag 

When fog Is enabled, the Rendering Engine performs fog blending. 

To learn about fog blending, see "7.3.9 Fog Blending" on page 285 . 


0 

Disable 

1 

Enable 


• DT[d14] : Depth test conditions 

When set to 1, another polygon can be pasted on a polygon that has already been rendered (decal 
polygon). 


0 

Rendering when the fragment's depth value is smaller than the depth buffer's depth value. 

1 

Rendering when the fragment's depth value is equal to the depth buffer's depth value. 
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• [d13-d12] : Polygon display specification 

• D1[d13] : 1-dot poiygon rendering specification 

This aiiows controi of whether 1 -dot poiygons are passed to the rendering engine. A 1 -dot poiygon 
is a poiygon where the coordinates (x, y) of aii the vertices are integrated into a singie coordinate 
as the resuits of geometry engine caicuiations. 


0 

Does not render If becomes a Tdot polygon 

1 

Renders even if becomes Tdot polygon 


When set to 1, 1-dot poiygons are aiways written to poiygon iist RAM and vertex RAM. 

When this is set to 0, the depth vaiue of the 1 -dot poiygon controis whether to write the poiygon to 
poiygon iist RAM and vertex RAM or to discard it. 

Set the dispiay boundary depth vaiue of 1-dot poiygons with the Dispi DotDepth register. 

• FC[d12] : Far piane intersecting poiygon dispiay specification 


0 

Deletes if intersects the far plane 

1 

Clips if intersects the far plane 


Note that ciipping on the far piane increases the ioad on the Geometry Engine. 

• XL[d11] : Transiucent poiygon depth-vaiue update enabie fiag 

Seiect whether to update the depth buffer when rendering a poiygon with an a vaiue of 1-30. 

When this is set to 1, sometimes you can improve on a situation where too much fog is appiied in 
regions where transiucent poiygons are being rendered. Flowever, you need to be carefui because 
sometimes the edge-marking of background is not rendered correctiy. 


0 

Does not update the depth buffer when rendering translucent polygons 

1 

Updates the depth buffer when rendering translucent polygons 


• [d07-d06] : Poiygon rendering screen specification 

The surface is the piane tracing the vertices counterciockwise. 
• FR[d07] : Render front surface 



If the specified screen is in the screen being dispiayed when the rendering specification is disabied, 
this poiygon wiii not be inciuded in the List RAM. 
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For quadrilateral polygons, if any of the first three vertices share the same coordinates, duplication will be 
detected by the hardware and the polygon is displayed as usual without regard to front or back. 
Furthermore, when the first three vertices do not overlap but are in a straight line, the straight line is not 
preserved due to a problem with precision in internal calculations. In this case, the surface may be 
determined to be the front or back according to the camera state. Use the following procedure to avoid this 
problem: 

• Change the order the vertices are sent 

• Have the second coordinate value be the same as the first or third coordinate value (Of the first 
three vertices, set 1 and 2 or 2 and 3 to the same value) 

• Separate into triangles 

When rendering a line segment in which polygon vertex coordinates overlap, front/back determination is 
impossible, and therefore it is always rendered, regardless of this flag’s setting. 

• PM[d05-d04] : Polygon mode 

Modulation mode and decal mode are ways of blending texture color and fragment color. 

Toon / Highlight shading is a way to transform with the fragment color table. 

Shadow polygon is a feature for applying shadow using the stencil buffer. 

For details, see the respective parts in the Rendering Engine "7.3.1 Overview" on page 251 . 


00 

Modulation mode 

01 

Decal mode 

10 

Toon / Highlight shading 

11 

Shadow polygon 


About Toon/Hiahliaht Shading 

Toon and Highlight Shading share use of the same table. 

Use the DISP3DCN register to choose either Toon or Highlight. 

The setting written to the DISP3DCN register becomes valid when the frame switches, so Toon and 
Highlight Shading cannot be mixed in the same drawing frame. 

• L3-L0[d03-d00] : Light enable flags 

These are separate flags for setting lights 0-3. 


0 

Disable (light off) 

1 

Enable (light on) 
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Where to issue the PolvaonAttr command 

The values set with the PolygonAttr command become valid when the Begin command is issued. The 
vaiues are subsequentiy used as vertex attributes. 

Do not issue the PoiygonAttr command between the Begin command and the End command. 

Simpiy setting the iight enabie fiag to enabied in the Begin command does not affect the vertex coior. 

The vertex coior is first affected when lighting (iighting process) is performed with the Normai command 
after the iight enabie fiag setting is enabied in the Begin command. 

DispIDotDepth: 1-Dot Polygon Display Boundary Depth Value Register 

Name: DISP_1 DOT_DEptH Address: 0x04000610 Attribute: W Initial value: 0x7FFF 



Fixed-point number (12-bit integer -i- 3-bit fractionai part) 

• W coordinates [d14-d00] : Depth vaiue 

When the PoiygonAttr command’s “1-dot poiygon rendering specification fiag” is 0, the Geometry 
Engine references this register for use as described beiow: 

When the X and Y coordinates of aii poiygon vertices are transformed into BG screen coordinates 
within a range of 1 dot or iess, if the smaiiest W vaiue (the depth vaiue) is iarger than this register’s 
setting vaiue, poiygon data is not written to Poiygon List RAM or Vertex RAM (and is not dispiayed as 
a resuit). 

This W vaiue is referenced even during Z buffering. 
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7.2.13 Polygons 

BEGIN_VTXS: Declare the Start of the Vertex List 

Name: BEGIN VTXS Address: 0x04000500 Attribute: W Command Code: 0x40 



• TYPE[d01-d00] : Primitive type 


00 

Triangle 

01 

Quadrilateral 

10 

Triangle Strips 

11 

Quadrilateral Strips 


Poiygon strips share vertices, so they consume iess Vertex RAM than independent poiygons of the 
same shape. 

The tabie beiow shows the reiation between drawing and the order in which vertices are issued by the 
Vertex command for different types of primitives. 


Relation Between Drawing and the Order in Which the Vertex Command Issues Vertices 


Triangle Polygon 

A series of triangles are drawn starting with vertices ‘VO, v1, and v2” and then vertices “v3, 
v4, and v5.” 

Quadrilateral Polygon 

A series of quadrilaterals are drawn starting with vertices ‘‘vO, v1, v2, and v3” and then 
vertices ‘‘v4, v5, v6, and v7.” 

Triangle Strips 

A series of triangles are draw starting with vertices “vO, v1, and v2,” ‘‘v2, v1, and v3” and 
then ‘‘v2, v3, and v4.” This is the order so that the triangles are drawn in the same direction 
on both sides of the surface. (See Figure 7-15.) 

Quadriiaterai Strips 

A series of quadrilaterals are drawn starting with vertices ‘‘vO, v1, v3, and v2,” “v2, v3, v5, 
and v4” and then “v4, v5, v7, and v6.” This is the order so that the quadrilaterals are drawn 
in the same direction on both sides of the surface. (See Figure 7-15.) 


Defining the primitive's front surface 

The surface is described counterciockwise (vO, v1, v2,... : in order of issued Vertex-group commands). 


Figure 7-19 : Order in Which the Vertex Commands Issues Vertices 


vO v2 



Triangle Triangle Strips 


vO 


v1 


v3 

v2 


Quad 


v4 



When you want to draw iine segments, set the same vaiue for neighboring vertices in the above primitives. 
However, because it is not possibie to determine the front or back of the iine segments, they are aiways 
rendered, even if the poiygon attributes specify to disabie dispiay. As Figure 7-20 shows, the anti-aiiasing 
and edge marking features (see the Rendering Engine "7.3.1 Overview" on page 251) work on iine 
segments as weii. 
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Figure 7-20: Line Segment Using Sides from a Triangie 


vO 

v1 - 

v2 

When you draw quadrilateral polygons in the shapes shown in Figure 7-21, sometimes the resuits are not 
as intended. Be sure to set the vertices so quadriiaterai poiygons are not drawn in these shapes. 

Figure 7-21: Quadriiaterai Poiygon Shapes that Yieid Unintended Shapes 



Quadriiaterai with Concave Twisted 

Intersecting Sides Quadriiaterai Quadriiaterai 

End: Declare the End of the Vertex List 

Name: END VTXS Address: 0x04000504 Attribute: W Command Code: 0x41 


31 24 

23 16 

15 8 

7 0 


































































Make certain to issue Begin and End commands in pairs. 

Color: Directly Set the Vertex Color 

Name: COLOR Address: 0x04000480 Attribute: W Command Code: 0x20 


31 


24 


23 


16 


15 14 


10 9 8 7 


5 4 



















BLUE 

GREEN 

RED 


















Color 


The vertex coior remains vaiid untii the current vertex coior is updated by the next Coior command, Normai 
command, or MateriaiCoiorO (vertex coior set fiag) command. 

Thus, muitipie vertices can share the same vertex coior. 

Because the vertex coior is bandied as bits R:G:B = 6:6:6 in the Rendering Engine, the diffuse refiection 
coior is appiied to the upper five bits. When set coior vaiue is 0, the iower 1 bit is 0, and when it is nonzero, 
the iower 1 bit is 1. 

The Coior command is usuaiiy issued between the Begin and End commands, but it can aiso be issued 
before the Begin command. 


Command string 
Example 1 

Begin^Color^Vertex^Vertex^Vertex^End 

Command string 
Example 2 

Color^Begin^Vertex^Vertex^Vertex^End^Begin^Vertex^Vertex^ 

Vertex^End 
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Normal: Set the Normal Vector 

Name: NORMAL Address: 0x04000484 Attribute: W Command Code: 0x21 


31 30 29 28_24123_20 19 18 16|l5_10 9 8 | 7_0 




s 

NZ 

B 

NY 

S 

NX 



Normal vector’s Z component 

Normal vector’s Y component 

Normal vector’s X component 


Signed fixed-point number (sign -i- 9-bit fractionai part) 

Lighting (iiiumination process) is performed oniy when the Normai command is executed. 

Accordingiy, you need to reissue the Normai command after you switch iighting On/Off or change the iight 
or materiai parameters in order for the change to be refiected in the vertex coior. (See note.) 

Further, the hardware does not normaiize vectors, so you need to set the unit vector. 

The vertex coior obtained with the iighting process remains vaiid untii the current vertex coior is updated by 
the next Coior command, Normai command, or MateriaiCoiorO (vertex coior set fiag) command. 

Thus, in actuaiity muitipie vertices can share the same normai vector. 

Note: To turn iight on or off after setting in the PoiygonAttr command, first enabie the set vaiue with the 
Begin command and then issue the Normai command. 

Where to Issue the Normal command 

The Normai command is usuaiiy issued between the Begin and End commands, but it can aiso be issued 
before the Begin command. 


Command string 
Example 1 

Begin^Nermal^Vertex^Vertex^Vertex^End 

Command string 
Example 2 

Normal^Begin^Vertex^Vertex^Vertex^End^Begln^Vertex^Vertex^ 

Vertex^ End 


VTX_16: Set the Vertex Coordinates 

Name: VTX 16 Address: 0x0400048C Attribute: W Command Code: 0x23 


31 30 


28 27 


24 23 


16 


15 14 


12 11 


8 7 



INT_Y 

DECIMAL.Y 


INT_X 

DECIMAL.X 

Y Coordinate 

X Coordinate 


Signed fixed-point number (sign -i- 3-bit integer -i- 12-bit fractionai part) 
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VTX_10: Set the Vertex Coordinates 

Name:VTX_10 Address: 0x04000490 Attribute: W Command Code: 0x24 

|31 29 28 26 25 24|23_20 19 18 16|l5_10 9 8 | 7 5_oj 



Signed fixed-point number (sign -i- 3-bit integer -i- 6-bit fractionai part) 

VertexXY: Set the Vertex XY Coordinates (for Z Coordinate, Use the Last-Set Data) 

Name: VTX XY Address: 0x04000494 Attribute: W Command Code: 0x25 


31 30 28 27_24123_16|l5 14 12 11_8j7_0^ 



Signed fixed-point number (sign -i- 3-bit integer -i- 12-bit fractionai part) 

VertexXZ: Set the Vertex XZ Coordinates (for Y Coordinate, Use the Last-Set Data) 

Name: VTX XZ Address: 0x04000498 Attribute: W Command Code: 0x26 


31 30 28 27_24123_16|l5 14 12 11_ sJt_0 



Signed fixed-point number (sign -i- 3-bit integer -i- 12-bit fractionai part) 

VertexYZ: Set the Vertex YZ Coordinates (for X Coordinate, Use the Last-Set Data) 

Name: VTX YZ Address: 0x0400049C Attribute: W Command Code: 0x27 


31 30 28 27_24123_16|l5 14 12 11_ sJt_0 



Signed fixed-point number (sign -i- 3-bit integer -i- 12-bit fractionai part) 


TWL-06-0017-001-D 
Released: February 16, 2009 


228 


© 2008-2009 Nintendo 
CONFIDENTIAL 


































TWL Programming Manual 


VertexDiff: Set the Difference Value of the Last-Set Data for Vertex Coordinates 


Name: VTX_DIFF 

Address: 0x040004A0 

Attribute: W 

Command Code: 0x28 

131 29 28 

24|23 20 19 18 16|l5 

10 9 8 1 7 

0 





sz 

DECIMAL_Z 

SY 

DECIMAL.Y 

SX 

DECIMAL_X 



Z Coordinate 

Y Coordinate 

X Coordinate 


Signed fixed-point number (sign -i- 9-bit fractionai part) 

The vaiue after adding to the iast-set vertex vaiue is stored as the 16-bit vertex coordinates. 

The VertexDiff command data is sign-extended to 16 bits and added to the prior-set vertex coordinate. The 
vertex coordinates (the Vertex-group command's data) are 16 bits in size (sign -i- 3-bit integer -i- 12-bit 
fractionai part), so the data of the VertexDiff command corresponds to the 4th to 12th piaces of the 
fractionai part of the vertex coordinates (see Figure 7-22.) 

Note: Use caution because an overfiow can occur during the addition process. 

Figure 7-22: The Process for Adding the X Coordinate 


VertexDiff command data 


Expanded to 16 bits 

i 

Addition 


i 


Last-set vertex coordinates 


9 8 7 


SX 


15 


DECIMAL X 


8 7 


SX 

SX SX SX 

SX SX SX DECIMAL_X 

15 14 12 

O 

r^ 

00 

SX 

INT_X 

DECIMAL_X 


Items common to all Vertex commands 

When Vertex commands are issued, the vertex data that have been transformed into BG screen 
coordinates are stored in Vertex RAM. Further, poiygon data is stored to Poiygon List RAM when the data 
for the number of vertices comprising the poiygon are processed. 

Note: Be sure to issue Vertex commands between the Begin command and the End command and that 
there are not too many or too few vertices in the specified primitives. 

Cautions for polygons during clipping 

When a poiygon is ciipped, the G vaiue, B vaiue, or both on the dipping piane poiygon wiii occasionaiiy 
change to 0, causing coior distortion. Figure 7-23 represents the state in which this has occurred (the G 
vaiue and the B vaiue have both changed to 0). When caicuiating the coior of the vertex newiy created 
through ciipping, the coior vaiue may become a vaiue higher than 31. When this happens, the iast 5 bits of 
the vaiue truncated to 32 wiii become the finai coior, incorrectiy making it 0. This does not occur for the R 
vaiue because the caicuiation accuracy is higher than the other two. This resuits in a reddish dispiay. 

Note: If the circuit revisions for the geometry circuit are enabied in TWL mode, this phenomenon wiii not 
occur (configure this with the SCFG_EXT register). 
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This issue may be avoided by using the foiiowing methods: 

• Set the poiygon scaiing smaii to assure high geometry caicuiation accuracy. 

• Shorten the vertex intervai of the poiygons or puii the vertex away from the ciipping piane to reduce the 
effect of the errors stemming from iow caicuiation accuracy. 

• if the vertex coior is directiy configured through a modeiing software, set the vertex coior to be (R, G, 
B) = (31,30, 30) or smaiier. 

• if the vertex coior is not directiy configured, adjust the materiai or iight coior so that the caicuiated 
vertex wiii be (R, G, B) = (31,30, 30) or smaiier. 

Figure 7-23: Polygon Clipping Color Distortion 


Clipping Piane 



V2 

RGB=(31,31.31) 
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7.2.14 Texture Mapping 

TexCoord: Set Texture Coordinates 

Name: TEXCOORD Address: 0x04000488 Attribute: W Command Code: 0x22 


31 

30 

24 23 

16 

15 

14 

CO 

•>4 

0 


INTEGER.T 

DECIMAL.T 

SS 

INTEGER.S 

DECIMAL.S 

T Coordinate 

S Coordinate 


Signed fixed-point number (sign -i-11-bit integer -i- 4-bit fractionai part) 

• TEX T, TEX_S[d31-d16], [d15-d00]: Texture coordinates 

As Figure 7-24 shows, the texture coordinates set the coordinates in texture image space, treating the 
texei size as 1.0 (4-bit fractionai part). 

Figure 7-24: Texture Image Space (for an Image of 1,024x1,024 Texels) 


-2,048 


-S Axis- 


-2,048 


T Axis 



Texture 

Image 


-r2,047.9375 


4-2,047.9375 


The texture coordinates remain vaiid untii the next TexCoord command resets the current texture 
coordinates. 

Because of this, the same texture coordinates can be shared by muitipie vertices. 


Where to issue the TexCoord command 

The TexCoord command is normaiiy issued between the Begin command and the End command, but it 
can aiso be issued before the Begin command. 


Command String 
Example 1 

Begin^TexCoord^Vertex^Vertex^Vertex^End 

Command String 
Example 2 

TexCoord^Begin^Vertex^Vertex^Vertex^End^Begin^Vertex^Vertex^ 

Vertex^End 


When texture mapping, the Geometry Engine works faster if you issue commands in the foiiowing order: 
TexCoord^Normai^Vertex. 
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TexImageParam: Setting the Texture Parameters 

Name: TEXIMAGE PARAM Address: 0x040004A8 Attribute: W Cemmand Code: 0x2A 


31 30 29 28 26 25 24 23 


20 19 18 17 16 15 


□ 

□ 


□ 

□ 

□ 

T_SIZE 

S_SIZE 

B 

B 

m 


□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 





Texture Size 

□ 

□ 

□ 

□ 

Texture's Starting Address in VRAM 


Texture Format 


Flip 


Repeat 


Enable Flag for Palette 
Color 0 Transparency 


Texture Coordinates 
Transformation Mode 


• TGEN[d31-d30] : Texture coordinate transformation mode 


00 

Do not transform texture coordinates 

01 

TexCoord source 

10 

Normal source 

11 

Vertex source 


• TR[d29] : Enabie fiag for the paiette's coiorO transparency 

When using transparent texeis with 4-, 16-, and 256-coior paiette textures, set this bit to 1 so the 
paiette's coiorO can be referenced for the transparent coior. 


0 

Enable the palette's coiorO setting 

1 

Make appear transparent, regardless 
of the palette coiorO setting value 


• TEXFMT[d28-d26] : Texture format 


0 

No texture 

1 

A3I5 translucent texture 

2 

4-color palette texture 

3 

16-color palette texture 

4 

256-color palette texture 

5 

4x4 texel compressed texture 

6 

A5I3 translucent texture 

7 

Direct texture 
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• [d25-d20] : Texture size 

• T_SIZE, S_SIZE 

Selects texture size of 8 x 8 to 1,024 x 1,024. 


0 

8 texels 

1 

16 texels 

2 

32 texels 

3 

64 texels 

4 

128 texels 

5 

256 texels 

6 

512 texels 

7 

1,024 texels 


• [d19-d18] : Flip 

Specifies whether to flip the texture image up/down and/or left/right for mapping when the texture 
coordinates pertain to a region beyond the texture size. (See Figure 7-25 and Figure 7-26.) The flip 
setting is valid only when Repeat has been specified. 

• FT[d19] : Flip in direction of T coordinates 


0 

Do not flip 

1 

Flip 


• FS[d18] : Flip in direction of S coordinates 



1 Flip 


• [d17-d16] : Repeat 

Specifies whether to repeatedly map the texture image when the texture coordinates pertain to a 
region beyond the texture size. 

• RT[d17] : Repeat in the direction of the T coordinates 


0 

Do not repeat 

1 

Repeat 


• RS[d16] : Repeat in the direction of the S coordinates 


0 

Do not repeat 

1 

Repeat 


• TEX_ADDR[d15-d00] : Texture’s starting address in VRAM 

The system references the 3-bit left-shift of the texture’s starting address in VRAM. 
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Where to issue the TexImaaeParam command 

The TeximageParam command is normally issued before the Begin command, but it can also be issued 
between the Begin and End commands. By issuing it during the Begin-End interval you can set different 
texture parameters for every polygon inside the Begin-End command string. 

Note: A problem causes the previous polygon texture attributes to be overwritten with the parameters 
passed by the TeximageParam command, according to the process status of the geometry 
engine. 

Note: If the circuit revisions for the geometry circuit are enabled in TWL mode, this phenomenon will not 
occur (configure this with the SCFG_EXT register). 

The following examples show the positions in which to issue the TeximageParam command: 

• Outside the Begin-End interval: 


TeximageParam; 

Begin; 

TexCoord; 

Vertex; 

End; 


• Within the Begin-End interval with quadrilateral polygons: 

1. When the command structure for the polygon that has changed texture after the second 
polygon changes from TexCoord to Vertex: 

Begin; 


TeximageParam; 
First Polygon; 
TeximageParam; 
Normal; 


Send the Normal command as a dummy command 


Second Polygon; 


End; 


2. When the command structure for the polygon that has changed texture after the second 
polygon changes from TexCoord to Normal to Vertex: 

The problem can be resolved effectively by sending OxFF (undefined) as the dummy 
command, in place of the Normal command sent in the first example. However, when the 
TexPlttBase command is send with the TeximageParam command, this problem does 
not occur, and there is no need to send a dummy command. 

• Within the Begin-End interval with triangle polygons: 

1. When the command structure for the polygon that has changed texture after the second 
polygon changes from TexCoord to Vertex: 

Same as example 1 for quadrilateral polygons. 

2. When the command structure for the polygon that has changed texture after the second 
polygon changes from TexCoord to Normal to Vertex: 


No problems occur. 
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• Within the Begin-End intervai with triangie and quadriiaterai poiygons: 

In this case, aiways use End once when changing textures. In other words, limit issuing the 
TeximageParam command to a position before the Vertex command is issued, as shown 
below. 

Begin; 

TeximageParam; 

Vertex; 


End; 


• Texture Flip and Repeat Settings (For a Texture Image of 1,024 x 1,024 Texels) 
1. When when there is no repeat 

Figure 7-25: Texture Image Space (No Repeats) 


No Repeat 







0 


N 




} 


i 

II 



T-Axis 
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2. Flip settings when there is a repeat 

Figure 7-26: Texture Image Space (with Repeats) 



T-Axis 



T-Axis 


Flip in T-Coordinate Direction 



T-Axis 


Flip in S- and T-Coordinate Directions 



T-Axis 
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TexPIttBase: Set Texture Palette's Base Address 

Name: TEXPLTT BASE Address: 0x040004AC Attribute: W Cemmand Code: 0x2B 



• PLTT_BASE[d12-dOO] : Specifies the paiette's base address 

The system references a 2 to 4 bit ieft shift of the paiette’s base address. 

The shift voiume varies, depending on the texture format (see " Tabie 7-4 : Number of Geometry 
Command Run Cvcies & Timing Reiated to Command Issue (in Command Code Order) " on page 199). 


Table 7-5: PLTT BASE Values and Shift Volumes 


PLTT_BASE 

Value 

4-color 

Palette 

Texture 

16-color 

Palette 

Texture 

256-color 

Palette 

Texture 

4x4 texels 
Compressed 
Texture 

A3I5 Texture 

A5I3 Texture 

0x0000 

0x00000 

0x00000 

0x00000 

0x00000 

0x00000 

0x00000 

0x0001 

0x00008 

0x00010 

0x00010 

0x00010 

0x00010 

0x00010 

0x0002 

0x00010 

0x00020 

0x00020 

0x00020 

0x00020 

0x00020 








0x17FE 

OxOBFFO 

0X17FE0 

0X17FE0 

0X17FE0 

0X17FE0 

0X17FE0 

0x17FF 

0X0BFF8 

0X17FF0 

0X17FF0 

0X17FF0 

0X17FF0 

0X17FF0 

0x1800 

OxOCOOO 

Setting 

prohibited 

Setting 

prohibited 

Setting 

prohibited 

Setting 

prohibited 

Setting 

prohibited 








0x1FFE 

OxOFFFO 

Setting 

prohibited 

Setting 

prohibited 

Setting 

prohibited 

Setting 

prohibited 

Setting 

prohibited 

0x1FFF 

0X0FFF8 

Setting 

prohibited 

Setting 

prohibited 

Setting 

prohibited 

Setting 

prohibited 

Setting 

prohibited 


Where to issue the TexPIttBase command 


The TexPIttBase command is normaiiy issued before the Begin command, but it can aiso be issued 
between the Begin and End commands. By issuing it between these two commands you can set a 
different paiette base address for every poiygon between the Begin and End commands. 


Command String 
Example 1 

TexPIttBase^Begin^TexCoord^Vertex^TexCoord^Vertex^TexCoord^ 

Vertex^End 

Command String 
Example 2 

Begin^TexPIttBase^TexCoord^Vertex^TexCoord^Vertex^TexCoord^ 

Vertex^TexPIttBase^TexCoord^Vertex^TexCoord^Vertex^TexCoord^ 

Vertex^End 
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7.2.14.1 Texture Coordinate Transformations 

The texture coordinate transformation mode can be switched using the TeximageParam command. 

In the three modes described in this section, the vaiues given by the pertinent command are used as the 
input coordinates for the caicuiations. 

The vaiues after the coordinate transformation are not meant to be used, so make sure you set the texture 
matrix appropriateiy in advance. 


TexCoord source 

The texture coordinate transformation is performed using the vaiues set by the TexCoord command as 
the input coordinates. 

The coordinate transformation is executed when the TexCoord command is issued. 

You can produce a simpie texture scroii by setting a transiation matrix or a rotation matrix for the texture matrix. 


S' T R' 2 ] 


Operation Expressed in Matrix Form 


m[0] m[l] m[2] m[3] 

1 1 


m[4] m[5] m[6] m[7] 

16 16 


m[8] m[9] m[10] m[ll] 


m[12] m[13] m[14] m[15] 


Specific Expression Taking Decimai-Point Position into Account 

S' = {m[0] X (S « 12) + m[4] x (T« 12) + m[8] x (1 « 12) + m[12] x (1 « 12)} » 24 
T = {m[l] X (5 « 12) + m[5] X (r« 12) + m[9] X (1 « 12) + m[13] + (1 « 12)} » 24 

Normai source 

The texture coordinate transformation is performed using the vaiues set by the Normal command as the 
input coordinates. 

The coordinate transformation is executed when the Normal command is issued. 

The S and T vaiues set by the immediateiy-prior TexCoord command are used as the transiation 
components of the texture coordinates. 

You can produce sphericai refiection mapping by setting in the texture matrix the resuit of reading the 
current directionai vector matrix and muitipiying by the scaiing matrix that expands the directionai vector 
space (-1.0 to 1.0) to 1/2 the texture size. When doing this, use the TexCoord command to transiate the 
origin of the texture coordinate to the center of the sphericai texture. 


Operation Expressed in Matrix Form 


S' T R' = [nu Nv Nw 


m[0] 

m[l] 

m[2] 

m[3] 

m[4] 

m[5] 

m[6] 

m[7] 

m[8] 

m[9] 

m[10] 

m[ll] 

S 

T 

m[14] 

m[15] 
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Specific Expression Taking Decimai-Point Position into Account 

S' = {m[0] X {Nx « 3) + m[4] x {Ny « 3) + m[8] x {Nz « 3) + (5 « 12) x (1 « 12)} » 24 
T = {m[l]x{Nx«3) + m[5]x{Ny«3) + m[9]x{Nz«3) + iT« 12)x(l « 12)}»24 


Vertex source 


The texture coordinate transformation is performed using the vaiues set by a Vertex-group command as 
the input coordinates. The coordinate transformation runs when a Vertex-group command is issued. 

The S and T vaiues set by the TexCoord command issued immediateiy prior are used as the transiation 
components of the texture coordinates. 


You can produce texture scroiis dependent on the View coordinates by reading the current position 


coordinate matrix and setting it to the texture matrix. 




Operation Expressed in 

Matrix Form 



m[0] 

m[l] 

m[2] 

m[3] 


[s' T R' = 

[x Y Z 

m[4] 

m[5] 

m[6] 

m[7] 


L J 

m[8] 

m[9] 

m[10] 

m[ll] 




S 

T 

m[14] 

m[15]_ 



Specific Expression Taking Decimai-Point Position into Account 


S' = {m[0]xX-i-m[4]xy-i-m[8]xZ-i-(5« 12)x(l« 12)}»24 

T = {m[l] xX-i-m[5] X y-i-m[9] xZ-i-(r« 12)x(l« 12)}»24 

• Decimal point positions between parameters used by texture-coordinate transformation 
expressions 

The parameter formats used in the expressions for caicuiating texture coordinate transformations are 
shown in the foiiowing tabie. 

Therefore, to unify texture coordinate transformation caicuiations to 12-bit fractionai parts, the Normai 
coordinates couid be ieft-shifted by 3 bits, and the texture coordinates couid be ieft-shifted by 8 bits 
before the caicuiation is appiied. 

However, as can be seen in “Specific expression taking decimai-point position into account,” texture 
coordinates are ieft-shifted by 12 bits before the expression is appiied, and the resuits that are right- 
shifted by 24 bits are taken as the new texture coordinates. 

From this, it is naturai to assume that the texture coordinate transformation is (Sign -i- 15-bit integer -i- 
0-bit fractionai part). That is, texture coordinate transformation caicuiations use units of 1/16 texei, 
rather than units of 1 texei. 


Parameter Name 

Parameter 

Format 

Texture Matrix 

m[num] (num = 0-15) 

Sign + 19-bit integer + 12-bit fractionai part 

Normal Coordinate 

Nx, Ny, Nz 

Sign + 9-bit fractionai part 

Vertex Coordinate 

X,Y,Z 

Sign + 3-bit integer + 12-bit fractionai part 

Texture Coordinate 

S,T 

Sign + 11-bit integer + 4-bit fractionai part 
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• Technical tip 

There may be times when you are using poiygons to represent 2D graphics, and you want the texeis to 
have 1:1 correspondence with the pixeis on the LCD. Because texture sampiing proceeds from the 
upper ieft texei, the texture may be off by 1 texei due to such factors as poiygon rotation. To prevent 
this from happening, use a texture-coordinate transformation to adjust the position from the position at 
which sampiing starts. For detaiis, see "7.3.5.1.1 Texture Image Samojina" on oaoe 269 . 

• Polygon processing cycle count 

When there are two lights or fewer, the execution cycle of the geometry engine will not vary based on 
the availability of the Normal command. When there are three or more lights, the execution cycle will 
be faster without the Normal command. Also, regardless of the number of lights, the transfer time (bus 
usage time) to the command FIFO will be shorter if the Normal command is not executed. 

The following table values result from the fact that when the number of lights is small, the coordinate 
conversion will become the bottleneck even if the calculation cycle of the vertex color is short. 
Therefore the polygon operation will be fixed to the vertex coordinate conversion time. But when the 
number of lights increase, the vertex color calculation cycle will exceed this time. 


Command Structure 

Light Count for Triangular Polygons 

Light Count for Quadrilateral 
Polygons 

OFF 

Ich 

2ch 

3ch 

4c h 

OFF 

Ich 

2ch 

3ch 

4c h 

TexCoord -> Normal -> Vertex 

28 

28 

28 

30 

33 

37 

37 

37 

40 

44 

Normal -> Vertex 

28 

28 

28 

28 

30 

37 

37 

37 

37 

40 

TexCoord -> Vertex 

28 

28 

28 

28 

28 

37 

37 

37 

37 

37 

Vertex 

28 

28 

28 

28 

28 

37 

37 

37 

37 

37 
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7.2.15 Tests 

When the Geometry Engine executes a test-related command (such as the status flag and the resulting 
register value), it updates the test command result. 

BoxTest: Test if Cuboid Sits Inside View Volume 

Name: BOX TEST Address: 0x04000500 Attribute: W Command Code: 0x70 



Signed fixed-point number (sign + 3-bit integer -i- 12-bit fractional part) 


31 30 28 27 


24 23 


16 


15 14 12 11 


8 7 


SW INT W 


DECIMAL W 


SZ INT Z 


DECIMAL Z 


Width 


Z Coordinate 


31 30 28 27 


24 23 


16 


15 14 12 11 


8 7 


SD INT D 


DECIMAL D 


SH INT H 


DECIMAL H 


Depth 


Height 


Specify the box's standard vertices of the box shown in Figure 7-27 for the coordinate values. 
The result of the Box test is stored in the Geometry Engine Status register (GXSTAT). 

Figure 7-27: Box to Be Tested 



• Box Test Contents 

Determines whether any of the six faces of the box are not completely within the view volume. 

For this reason, if the view volume is completely contained within the box, it is considered out of view. 

Note: If the circuit revisions for the geometry circuit are enabled in TWL mode, this phenomenon will 
not occur (configure this with the SCFG_EXT register). 
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• Conditions Required to Properiy Run a Box Test 

Conduct the box test with both polygon attribute flags set to 1. If either of the flags is set to 0, the test 
results may not be correct. 

Keep in mind that overflow may occur when width/height/depth is added to the reference vertices. (The 
result of the addition must be greater than or equal to - 8.0 and less than 8.0.) 

1. Set both of the polygon attribute flags to 1: 

• Far plane-intersecting polygon display specification 

• 1 -dot polygon rendering specification 

2. Begin command 

3. End command 

4. BoxTest command 
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PositionTest: Set the Position Coordinates for the Tests 

Name: POS TEST Address: 0x040005C4 Attribute: W Command Code: 0x71 



Signed fixed-point number (sign -i- 3-bit integer -i- 12-bit fractionai part) 



Coordinate transformation is performed on the position coordinates for the test by the current ciip 
coordinate matrix. 

The resuits of the Position test (the ciip coordinates) are stored in the PositionResuit register. 

VectorTest: Set the Directionai Vector for the Tests 

Name: VEC TEST Address: 0x040005C8 Attribute: W Command Code: 0x72 


31 29 28_24123_20 19 18 16|l5_10 9 8 | 7_0 




m 

DECIMAL.Z 


DECIMAL.Y 


DECIMAL_X 



Z Component 

Y Component 

X Component 


Signed fixed-point number (sign -i- 9-bit fractionai part) 

Coordinate transformation is carried out on the directionai vector for the test by the current directionai 
vector matrix. 

The resuit of the Vector test (the directionai vector in the View coordinate space) is stored in the 
VectorResuit register. 

PositionResuit: Read the PositionTest Computational Results 

Name Address Attribute Initial Value 

POS_RESULT_x (x=X,Y,Z,W) 0x04000620,0x04000624,0x04000628, 0x040062C R 0x00000000 


31 30_24123_leJiS_12 11_ sJt_0 



INTEGER_x 

DECIMAL.x 


Integer Part 

Decimal Part 


Signed fixed-point number (sign -i- 19-bit integer -i- 12-bit fractionai part) 
The ciip coordinates vaiues (x, y, z, w) are stored in these registers. 
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VectorResult: Read the VectorTest Computational Results 

Name Address Attribute Initial Value 

VEC_RESULT_x (x=X,Y,Z) 0x04000630,0x04000632,0x04000634 R 0x0000 


15_12 11_8 7_0 


Sx 

INTEGER.x 

DECIMAL.x 

Sign 

Integer Part 

Decimal Part 


Signed fixed-point number (sign -i- 3-bit integer -i- 12-bit fractionai part) 

The directionai vector vaiues (x, y, z) of the view coordinate space are stored in these registers. 
The read-out computation resuits are within ±1, so the integer is a sign extension. 
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7.2.16 Status 

You can check the status of Polygon List RAM and Vertex RAM using the previousiy mentioned 
DISP3DCNT register. 

To check the status of command FIFO and matrix stacks, etc., see the GXSTAT register diagram beiow. 

GXSTAT: Geometry Engine Status Register 

Name: GXSTAT Address: 0x04000600 Attribute: R/W Initial Value: 0x00000000 


31 30 29 27 26 25 24 

23 16 

15 14 13 12 8 

7 1 0 

□ 

L 




E 

N 


□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

SE 

SB 

PJ 

PV 




■ 

■ 

■ 

03 

m 







Command FIFO Count 

Matrix Stack Status 




■ 

□ 

□ 

c 

□ 


Command FIFO Status 


Geometry Engine Busy Flag 


Conditions for Command 
FIFO Interrupt Requests 


Test Status 


• Fl[d31-d30] : Conditions for Command FIFO interrupt requests 


00 

Disable Command FIFO Interrupt requests 

01 

Make Interrupt request when Command FIFO Is less than half full 

10 

Make Interrupt request when Command FIFO is empty 

11 

Setting prohibited 


• B[d27] : Geometry Engine busy fiag 


0 

Geometry Engine is stopped 

1 

Geometry Engine is running 


If commands or parameters have not been sent, the busy flag goes to the command wait / parameter 
wait status with the busy flag set to 0. 

When commands or parameters resume, geometry processing resumes. 

When a SwapBuffers command is issued, and no subsequent commands are issued, the geometry 
engine busy flag is set to 0 at the completion of a SwapBuffers process, which begins with a V- 
Blank. (It is 1 until then.) 

This timing occurs 400 cycles (calculated at 33 MHz) after the V-Blank. 

If, after the SwapBuffers command is issued, a next command is also issued, the next command 
is executed after the completion of the SwapBuffers process, which commences after the V-Blank. 
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• [d26-d24] : Command FIFO status 

• E[d26] : Command FIFO empty flag 



• [d23-d16] : Command FIFO count value 

Can reference the number of commands/amount of data currently stored in Command FIFO. 

• [d15-d08] : Matrix stack status 
• SE[d15] : Stack error fiag 

The fiag is set to 1 when an overfiow or underfiow of the matrix stack occurs. 

It can be cleared by writing 1. 


0 

No stack overflow or underflow 

1 

Stack overflow or underflow 


When referencing the status error flag of matrix stack status, confirm that the PushMatrix and 
PopMatrix commands that have been issued have completed by first referencing the matrix 
stack busy flag. 

• SB[d14] : Matrix stack busy flag 

• When referencing PJ and PV matrix stack levels, check this flag to confirm that execution of the 
issued PushMatrix or PopMatrix command has completed. 


0 

There Is no unexecuted PushMatrix or PopMatrix command. 

1 

The PushMatrix or PopMatrix command has been Issued, and the execution Is not yet 
completed. 


• PJ[d13] : Projection matrix stack level 

Can reference the current stack level (0-1) 

• PV[d12-d08] : Position and Vector matrix stack level 

Can reference the current stack level (0-31) 
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• [dOI-dOO] : Test status flag 
• TR[d01] : Box test result 


0 

All the faces that constitute the box are outside the view 
volume. 

1 

Of the six faces that constitute the box, part of one of 
the faces, or all are Inside the view volume. 


• TB[dOO] : Test busy flag 

Can reference the ready/busy status of each test (BoxTest, PositionTest, VectorTest). 


0 

Ready 

1 

Busy 


LISTRAM_COUNT: Polygon List RAM Count Register 

Name: LISTRAM COUNT Address: 0x04000604 Attribute: R Initial Value: 0x0000 


15 


11 






















Polygon-List RAM Counter 


• [d11-d00] : Polygon List RAM counter (Maximum vaiid vaiue is 0x800) 

You can reference the number of opaque poiygons + transiucent poiygons that are currentiy stored in 
Poiygon List RAM. 

Poiygon List RAM has a capacity of 2048 poiygons, so the maximum vaiid vaiue is 0x800. 

The poiygon iist RAM counter is cieared 10 system ciock cycies (33.5MHz) after the V-Biank that 
comes immediateiy after the SwapBuf f ers command is issued. 

VTXRAM_COUNT: Vertex RAM Count Register 

Name: VTXRAM COUNT Address: 0x04000606 Attribute: R Initial Value: 0x0000 


15 


12 





















Vertex RAM Counter 


• [d12-d00] : Vertex RAM counter (Maximum vaiid vaiue is 0x1800) 

You can reference the number of vertices that are currentiy stored in Vertex RAM. 

Vertex RAM has a capacity of 6144 vertices, so the maximum vaiid vaiue is 0x1800. 

The vertex RAM counter is cieared 10 system ciock cycies (33.5MHz) after the V-Biank that comes 
immediateiy after the SwapBuf fers command is issued. 
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7.2.16.1 Data Storage Capacity of Polygon List RAM and Vertex RAM 

1. Polygon List RAM 

The 52 KB of Polygon List RAM is divided into an ORDER area of 12 KB, foiiowed by a POLYGON 
area of 40 KB. The number of poiygons that can be stored in these two areas of Poiygon List RAM 
does not change when poiygons are connected, but because connected poiygons share vertices, the 
same number of poiygons consume iess memory if they are connected. This is an effective way to 
economize on Vertex RAM. 

No matter how the poiygons are drawn, the ORDER area of Poiygon List RAM can store 2048 
poiygons. However, the storage capacity of the POLYGON area varies, depending on the conditions 
under which poiygons are drawn. In this area, the poiygon data comprises a header region of 12 bytes 
foiiowed by a vertex index region of 8 or more bytes. Normaiiy, each trianguiar poiygon consumes 8 
bytes of the vertex index region, and each quadriiaterai poiygon consumes 12 bytes. Accordingiy, the 
maximum number of poiygons that can be stored in the POLYGON area is caicuiated as foiiows: 

(Connected) trianguiar poiygons: 40 KB / (12 byte header + 8 bytes) = 2048 poiygons 

(Connected) quadriiaterai poiygons: 40 KB / (12 byte header + 12 bytes) = 1706 poiygons 

Note that 4 bytes in the vertex index region are consumed each time the number of vertices increases 
due to ciipping. This means that the totai number of poiygons that can be stored in the POLYGON area 
decreases by one poiygon for every five ciippings performed on trianguiar poiygons and for every six 
dippings performed on quadriiaterai poiygons. 

2. Vertex RAM 

The 72 KB of Vertex RAM is fuiiy avaiiabie to store vertex data. Each vertex consumes 12 bytes. 

Tabie 7-6 shows the amount of vertex RAM consumed and the maximum number of poiygons that can 
be stored for each primitive type. 


Table 7-6: Vertex RAM Consumed and the Maximum Number of Polygons Stored per Primitive Type 


Primitive Type 

Vertex RAM Consumption 

Maximum No. of Polygons that Can Be Stored 

Triangle Polygon 

3 vertices per polygon 

2048 

Quadrilateral 

Polygon 

4 vertices per polygon 

1536 

Connected 
Triangle Polygons 

First polygon: 3 vertices 

Later polygons: 1 vertex 

6142 

However, with 2050 vertices, the Polygon List RAM 
maximum of 2048 polygons is reached. 

Connected 

Quadrilateral 

Polygons 

First polygon: 4 vertices 

Later polygons: 2 vertices 

3070 

However, with 3414 vertices, the Polygon List RAM 
maximum of 1706 polygons is reached. 


Because ciipping aiso consumes Vertex RAM, connect poiygons whenever possibie as an effective 
method to avoid Vertex RAM overfiow. 


a. Why shared vertices are released during both Z-Buffering and W-Buffering 

When ciipping is performed on connected poiygons, the shared vertices between neighboring 
poiygons are reieased. 
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b. Why shared vertices are released only during Z-Buffering 

During Z-buffering, shared vertices are reieased if the W vaiues (twice the dip-coordinate W 
vaiues) stored in Vertex RAM for neighboring connected poiygons are such that the W vaiue for 
even one vertex of one of the poiygons exceeds 16 bits (15 bits in ciip coordinates) whiie not 
exceeding 16 bits for any of the vertices of the other poiygon. (See Figure 7-28.) This happens 
because the Z vaiue and the W vaiue are both stored in Vertex RAM during Z-buffering, so the 24- 
bit W vaiue can oniy be stored with 16-bit precision. What is stored is either the upper 16 bits or 
the iower 16 bits of the 24-bit W vaiue, with the resuit that differences arise between poiygons. 
This situation does not arise during W buffering because there is no need to store the Z vaiue to 
vertex RAM during W buffering. Therefore, the 24-bit W vaiue of the ciip coordinate wiii be stored 
as it is, and the reiease of shared vertices does not occur. 

Figure 7-28: Release of Shared Vertices Among Connected Polygons (Clip Coordinate System) 


y 



z axis: 24-bit W vaiue 

To read about n, f, scaieW, 24-bit W vaiues see "7.2.5 Depth Buffering" on page 187 . 

c. Reasons for released vertices In the polygon attribute settings for rendering 1-dot 
polygons 

If "Do not render 1-dot polygons" is set in the polygon attributes and the polygon's W value 
exceeds the value in the 1-dot polygon display boundary depth value register, the vertices shared 
among the connected polygons will be released. In this case, whether or not a shared vertex will 
be released is decided for each polygon. Therefore, groups of polygons that do not exceed the 
value in the 1-dot polygon display boundary depth value register will share vertices unaltered. To 
avoid this, set "Display 1-dot polygons" in the polygon attributes. 

Note: If the circuit revisions for the geometry circuit are enabled in TWL mode, the shared verti¬ 
ces will not be released (configure this with the SCFG_EXT register). 
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4. Memory capacities and the storabie number of poiygons 

The table shows the relationship between the capacity of each memory region and the number of 
poiygons that can be stored in each region. 


Memory Region 

Relational Expression for Storable No. of Polygons & Memory Capacity 

The POLYGON Area of Polygon 
List RAM 

(12+8) X (F3+MF3) + (12+12) x (F4+MF4) + 4 x CLIP <= 40KB 

Vertex RAM 

(12 X 3) X (F3+MP3+DMF3) + (12 x 1) x (MF3-MP3-DMF3) + 

(12 X 4) X (F4+MP4+DMF4) + (12 x 2) x (MF4-MP4-DMF4) + 

12xCLIP<= 72KB 


F3: Number of trianguiar poiygons 

MF3: Number of connected trianguiar poiygons 

MP3: Number of primitives of connected trianguiar poiygons 

F4: Number of quadriiaterai poiygons 

MF4: Number of connected quadriiaterai poiygons 

MP4: Number of primitives of connected quadriiaterai poiygons 

CLI : Number of times ciipping occurs 

DMF3: Number of times vertices reieased for connected trianguiar poiygons 
DMF4: Number of times vertices reieased for connected quadriiaterai poiygons 

5. Summary 

The actuai number of poiygons that are rendered is iimited by the iesser of the number of poiygons 
that can be stored in Poiygon List RAM and in Vertex RAM. 

When extensive use is made of poiygon strips, Vertex RAM has pienty of space. Therefore, you can 
estimate, based on the capacity iimitations of Poiygon List RAM. 

If you make extensive use of poiygon strips, even in the unusuai situation where every poiygon is 
dipped once, you can be sure to obtain these numbers of poiygons: 

Trianguiar poiygon strips: 40 KB / (12 + 8 + 4) = 1706 poiygons 

Quadriiaterai poiygon strips: 40 KB / (12 + 12 + 4) = 1462 poiygons 

7.2.17 Warnings Regarding Caicuiation Precision 

Aithough you can specify a 32-bit space for the worid coordinate system (sign -i- 19-bit integer -i- 12-bit 
fractionai part) with TWL, objects on the edges of this 32-bit space may appear distorted and wrapped 
because the computationai precision of the hardware is aiso 32 bits. To use the worid coordinate system 
without probiems, keep within a range of 29 bits (sign -i- 16-bit integer -i- 12-bit fractionai part). 

TWL aiso has a 24-bit view space (sign 1 bit -i-11-bit integer -i- 12-bit fractionai part). Objects can appear 
distorted and wrapped if you specify some other space as the view voiume. 
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7.3 Rendering Engine 

In TWL mode, it is possibie to use the revised circuits for the foiiowing features that had probiems on 
NITRO by means of the system configuration. However, in NITRO compatibiiity mode, it wiii be necessary 
to foiiow the notes to work around the probiems. 

• Shadow : Refer to " 7.3.4.4 Shadow Poivoons " on page 262. 

• 4x4 Texei Compressed Textures : Refer to " 7.3.5.2.1.4 4x4 Texei Compression Textures " on page 275. 


7.3.1 Overview 

Tabie 7-7 iists the rendering engine specifications. 


Table 7-7: Rendering Engine Specification List 


Operating frequency 

33.514 MHz 

Render data 

Triangles and quadrilaterals 

Rendering capacity 

Maximum 120,000 polygons/sec (60FPS) 

Maximum 30 million pixels/sec (60FPS) 

Shadow surface 
process 

Switch between Z-value buffering and W-value buffering methods 

Shading 

Gouraud shading 

Texture mapping 

Perspective correction, modulation/decal 

Support for 4x4 texei compression 

Support for translucent textures 

Flip, Repeat 

Image sizes of 8x8 texels to 1024x1024 texels 

Other capabilities 
(See Table 7-8) 

Alpha blending, alpha test, anti-aliasing, edge marking, fog, toon shading, highlight 
shading, shadow, wireframe, Clear Image 
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Table 7-8 gives an overview of rendering engine features. 


Table 7-8: Overview of Rendering Engine Features 


Alpha Blending 

Blends the color value stored In the cclor buffer with the input fragment’s coler value based 
on the alpha value of that fragment (the fragments after texture blending). 

Alpha Test 

Compares the fragment's alpha value with the reference value set in the register and 
draws only if the fragment's alpha value Is larger than this reference value. 

(These fragments are the fragments after texture blending.) 

Antialiasing 

Blends the color of the polygcn's boundaries with color values of the polygcn behind It 
using the (5-blt width) factor computed based on the shift frcm the original display position. 

Edge Marking 

Marks the boundary edges of polygons with different polygen IDs (6-bit) using the polygon 
edge-specified cclor (8 colors). When anti-aliasing is enabled, the edge marking Is 
followed by anti-aliasing. 

Fog 

Using the fog density table, the specified fog's color value Is blended with the color buffer's 
coler value. The fog density can be specified in 32 levels, and the value that Is applied Is 
the value that results from linear interpolation with the depth value cf the target pixels. 
When 3D is displayed In frent of a 2D screen, fog can be applied to the 2D screen as well 
by using the ccicr buffer. 

Toon Shading 

Can present cartoen-llke pictures by steepening the shInIness calculaticn results. 

Highlight Shading 

Can present shInIness beyond the texture color. 

Shadow 

Can easily put shadcws cn even bumpy surfaces by defining the shadow volume. 

Wireframe 

Can draw only the edges of polygons without drawing the surfaces. 

Clear Image 

Can apply Clear Images In VRAM as the initial values for the color buffer's, depth buffer's 
and attribute buffer's fog-enable flags. 


Note: The rendering-reiated registers have a doubie-buffer structure, and the contents of each register 
are sent to the Rendering Engine at the start of the V-Biank period that begins right after the 
SwapBuf fers command is issued. Therefore, data can be written to these registers even during 
the middie of a frame. The data is not refiected in the image drawn in the frame at the time of the 
change. 
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7.3.2 Rendering Methods 

7.3.2.1 Line Buffer Rendering 

TWL employs a line-buffer method for rendering, rather than a frame-buffer method. Because of this, line 
overflow can occur when too many polygons are layered on a single line to be rendered during the 
horizontal period. To prevent line overflow from occurring easily, the color buffer operates FIFO, holding 48 
lines, and the rendering begins from the middle of the V-Blank period, drawing and storing the line data 
before display (see Figure 7-29.) 

By reading the RDLINES_COUNT register, you can check the minimum number of lines that remain in the 
color buffer while the frame that has been rendered is displaying. In other words, you cannot confirm 
whether or not lines have been dropped, but you can determine the risk of this happening. 

To read about the RDLINES_COUNT register see "7.3.11 Status" on page 292 . 

This diagram shows only the FIFO operation. The Rendering Engine is actually reading from and writing to 
the color buffer. 


Figure 7-29: Color Buffer's FIFO Operation 


Pixel Color Pixel Color 



Scanning 


7.3.2.2 Buffers in the Rendering Engine 

Table 7-9 shows the buffers in the Rendering Engine that store information about every pixel. 
Also see " Figure 7-1 : 3D Graphics Flardware Block Diagram " on page 177. 


Table 7-9: Buffers in the Rendering Engine 


Stencil buffer 

This buffer holds one line at 1 bit/pixel. 

It is used when rendering shadow polygons. 

Attribute buffer 

This buffer holds two lines at 23 bits/pixel. 

This buffer stores the polygon ID and fog enable flag for every pixel. 

Polygon IDs are managed separately for opaque polygons and translucent polygons. 

Depth buffer 

This buffer holds two lines at 24 bits/pixel. 

It is used for depth test and fog blending calculations. 

Color buffer 

This buffer holds 48 lines at 23 bits/pixel (R:G:B:A = 6:6:6:5). 
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7.3.2.3 Blank Periods 

The Rendering Engine begins rendering when scanning starts for the LCD's 214**^ iine, and it keeps 

rendering untii the start of dispiay of the 191®* finai iine. Thus, the Rendering Engine's biank period is the 
23 iines from iine 191 to 213 (see Figure 7-30). 

To safeiy rewrite data to the VRAM region (texture image and texture paiette) referenced by the Rendering 
Engine, do so during these 23 iines. 

Figure 7-30: Rendering Engine Bianking Periods 


CO 

CO 

CM 
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23 Lines 
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_J^ 


-355 Dots- 


-256 Dots- 


^ -99 Dots- ^ 


Rendering Period 


Rendering Blank Period 


Rendering Period 


Render Flow 



Table 7-10 shows the Rendering Engine timing specifications. 

Table 7-10: Rendering Engine Timing Specifications 


Item 

Spec 

Period 

Rendering 

Period 

Number of Horizontal Dots 

256 dots 

45.8316 jls 

Number of Vertical Lines 

49+191 lines 

15.2533 ms 

Totai Period 

Number of Horizontal Dots 

355 dots 

63.5556 |J.s 

Number of Vertical Lines 

263 lines 

16.7151 ms 

Biank Period 

Number of blank Lines 

23 lines 

1.4618 ms 

Scan Cycie 

V Cycie 

59.8261Hz 

16.7151 ms 
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7.3.2.4 Number of Polygons that Can Be Drawn with One Line 

The Rendering Engine can draw for a period of 355 dots with one iine. (See " Tabie 7-10 : Rendering 
Engine Timing Specifications " on page 254). 

Each dot invoives 6 cycies, but since there is aiso an overhead of 4 cycies for each iine, the number of 
cycies that can be used for rendering is (355 x 6) - 4 = 2126 cycies. 

In TWL, the fill rate for even texture-mapped translucent polygons is 1 pixel per cycle, but there is an 8- 
cycle overhead every time rendering of a polygon starts. 

Given these factors, the minimum guaranteed number of polygons that can be drawn on one line is: 

(2126 cycles) / (8 cycles + number of horizontal pixels in polygon). 

Excluding the overhead, the per-line fill rate is: 

(2126 cycles) - (8 cycles x guaranteed number of polygons drawn with one line). 

Using these formulas yields the results shown in Table 7-11. 


Table 7-11: Maximum Polygons Rendered per Line and Fill Rate (Calculated Values) 


Number of Horizontal Pixels in the Polygon 

8 

16 

32 

64 

128 

256 

Number of Polygons Guaranteed to Be Drawn by One Line 

132 

88 

53 

29 

15 

8 

Per-line Fill Rate 

1070 

1422 

1702 

1894 

2006 

2062 


Because the line buffer is FIFO, the actual number of polygons drawn may be higher. 
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7.3.3 Initializing the Rendering Buffers 
7.3.3.1 Initializing with the Clear Registers 

ClearColorAttr: Clear Color Attribute Register 

Name: CLEAR COLOR Address: 0x04000350 Attribute: W Initial value: 0x00000000 


31 


29 


24 


23 


20 


16 


15 14 


10 9 8 7 


5 4 


















F 

BLUE 

GREEN 

RED 



Clear Polygon ID 




a value 

Fog 

Color 


• Clear Polygon ID [d29-d24] : Polygon ID initial value 

Sets the initial value of the opaque Polygon ID in the Attribute buffer. Whether edge marking is appiied 
is determined by comparing the poiygon ID and this Ciear Poiygon ID in the case of edges that can be 
dipped at the edge of the screen. 

• a vaiue[d20-d16] : Initiai vaiue of a 

Sets the initiai vaiue of the a vaiue in the Coior buffer. 

Normaiiy, set this to 0 when compositing with 2D. 

• F[d15] : Fog enabie fiag 

Sets the initiai vaiue of the fog enabie fiag in the Attribute buffer. 

When compositing with the 2D screen, you can use this to controi whether or not to appiy fog to the 
rear piane. 

This is effective when you want to cieariy dispiay a 2D background. 

• Coior[d14-d00] : Ciear Coior RGB vaiues 
Sets the Coior buffer's initiai RGB vaiues. 

The Coior buffer in the Rendering Engine is (R:G:B = 6:6:6) bits, so the iower 1 bit is treated as 0 when 
the Ciear Coior vaiue is 0, and as 1 when the vaiue is non-zero. 

ClearDepth: Clear Depth Register 

Name: CLEAR_DEptH Address: 0x04000354 Attribute: W Initial value: 0x7FFF 



• CLEARDEptH[d14-d00] : Clear Depth value 

The Depth buffer in the Rendering Engine is 24 bits/pixei, so the Ciear Depth vaiue is used after 
shifting 9 bits to the ieft. The iower 9 bits are treated as 0, except when the Ciear Depth vaiue is 
0x7FFF, in which case the iower 9 bits are treated as 1. 

To read how this differs from the depth vaiue in the different depth buffering methods, see "7.2.5 Depth 
Buffering" on page 187 . 
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7.3.3.2 Initializing with Clear Images 

When the Clear Image Enable Flag Is set In the 3D Display Control register (DISP3DCNT), the Clear 
Images stored In VRAM are used as the Initial values of the Color buffer and Depth buffer and the Attribute 
buffer's fog enable flag. Even when this feature Is used, the value of the CLEAR_COLOR register Is still 
used for the Attribute buffer's polygon ID. 

Use the RAM Bank Control register to assign the VRAM that stores Clear Images to the Clear Image 
buffer. 

The format for each Clear Image Is given below. " Figure 7-31 : VRAM Mapping of Clear Images (Texture 
Image Slots 2 and 3 SharedV on page 258 shows Clear Image VRAM mapping. 

Ciear Coior Image Format 


15 14_10 9 8 I 7_5 4_0 


A 

BLUE 

GREEN 

RED 


Clear Color 


1 


Clear Alpha Flag 


• [d15] : Clear a flag 

The actual clear a values are as follows: 


0 

0x00 

1 

0x1 F 


• [d14-d00] : Clear Color RGB values 

• Sets the Color buffer's RGB Initial values. 

• The Color buffer In the Rendering Engine Is (R:G:B = 6:6:6) bits, so the lower 1 bit Is treated as 0 when 
the Clear Color value Is 0, and as 1 when the value Is non-zero. 

Ciear Depth Image Format 


15 


14 


FOG 

















Clear Depth 


Clear Fog 


• FOG[d15]: Clear Fog 

Sets the Initial value of the fog enable flag In the Attribute buffer. 

When compositing with the 2D screen, you can use this to control whether or not to apply fog to the 
rear plane. 

This Is effective when you want to clearly display a 2D background. 

•[d14-d00] : Clear Depth 

To read how this differs from the depth value In the different depth buffering methods, see "7.2.5 Depth 
Buffering" on page 187 
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Figure 7-31: VRAM Mapping of Ciear images (Texture image Siots 2 and 3 Shared) 
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ClearlmageOffset: Clear Image Offset Settings Register 

Name: CLRIMAGE OFFSET Address: 0x04000356 Attribute: W Initial value: 0x0000 


15 


















Y Offset 

X Offset 


Can assign offsets to the Clear Images that are read when the rendering buffers are initiaiized. The image 
is wrapped and read if it exceeds the 256x256 data region on screen. Figure 7-32 shows the ciear image 
offset. 
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Figure 7-32: Clear Image Offset 



© 2008-2009 Nintendo 
CONFIDENTIAL 


259 


TWL-06-0017-001-D 
Released: February 16, 2009 








TWL Programming Manual 


7.3.4 Rasterizing 

Rasterization is the process of dividing the poiygon surface into pixeis and writing them to a buffer. During 
rasterization, the Rendering Engine interpoiates the pixei coiors inside the poiygon, based on the vertex 
coiors passed from the Geometry Engine. 

The Rendering Engine stores the pixei coiors in the Coior buffer and stores each pixei's poiygon ID and fog 
enabie fiag in the Attribute buffer. The rendering engine first finishes rendering the opaque poiygon that are 
in poiygon iist RAM, and then renders the transiucent poiygons. 

7.3.4.1 Opaque Polygons 

An opaque poiygon is a poiygon with an a vaiue of 31 (a = 31). 

• Poiygon ID 

This is stored in the region for opaque poiygon IDs in the Attribute buffer when the poiygon is 
rendered. 

• Fog enabie fiag 

When an opaque poiygon is rendered, the fragment's fog enabie fiag overwrites the Attribute buffer's 
fog enabie fiag. 

7.3.4.2 Translucent Polygons 

A transiucent poiygon has either an a vaiue between 1 and 30 (1 < a < 30) or a transiucent texture 
appiied. 

Therefore, this term aiso encompasses shadow poiygons. 

7.3.4.2.1 Polygons with 1 < a < 30 

• Poiygon ID 

This is stored in the region for transiucent poiygon IDs in the Attribute buffer when the poiygon is 
rendered. 

When different transiucent poiygons overiap on the screen, a transiucent poiygon that uses the same 
poiygon ID as another translucent polygon is not overwritten. 

• Fog enable flag 

When a translucent polygon is rendered, the fragment's fog enable flag and the Attribute buffer's fog 
enable flag are combined with a logical AND operation, and the result is written to the Attribute buffer. 

This feature can be used to apply fog to everything except specific translucent polygons. 
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7.3.4.2.2 Translucent Texture-Mapped Polygons 

Translucent texture-mapped polygons (A3I5 and A5I3 textures) are stored in the translucent polygon 
region of the poiygon iist RAM, even if aii of the texeis are opaque. Therefore, they are rendered after 
opaque poiygons. Notice that processing of poiygon IDs and fog enabie fiags differs, according to whether 
the pixei is opaque (a=31) or transiucent (1 < a < 30). Therefore, opaque pixeis and transiucent pixeis 
may be mixed within a poiygon. 

• Poiygon ID 

• Opaque pixels 

When rendering polygons, these are stored in the attribute buffer’s opaque polygon ID area. 

Therefore, they are targeted for edge marking. 

• Translucent pixels 

When rendering polygons, they are stored in the attribute buffer’s translucent polygon ID area. 

If different translucent polygons overlap on the screen, translucent polygons that have the same 
polygon ID are not overwritten. 

• Fog enable flag 

• Opaque pixels 

Fragment fog enable flags are overwritten by the attribute buffer’s fog enable flags. 

• Translucent pixels 

When a translucent polygon is drawn, the fragment's fog enable flag and the Attribute buffer's fog 
enable flag are combined with a logical AND operation, and the result is written to the Attribute 
buffer. 

This feature can be used to apply fog to everything except specific translucent polygons. 

7.3.4.3 Wireframes 

A wireframe is a polygon with an a value of 0 (a = 0). In this case, a does not have its original meaning of 
opacity level. Instead, only the outline of the polygon (wireframe) is rendered. If it is clipped, the clipping 
boundary (a new side created due to clipping) is also rendered as a wireframe. To render a wireframe as 
translucent, map a translucent texture. 

Note: The characteristics of the circuit do not permit a wireframe to be drawn semi-transparently. 

About the Polygon ID 

When a wireframe is rendered, it is stored in the opaque polygon ID region of the attribute buffer. (Only the 
polygon ID of the wire is updated.) 
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7.3.4.4 Shadow Polygons 

Shadow volume is defined as the space that is not iiiuminated by iight because the iight has been 
obstructed by an object. A shadow, then, can be thought of as something that is generated in the region 
where the shadow voiume intersects with another object. The poiygon used to express a shadow voiume 
is caiied a shadow polygon. 

You can create a shadow image that can be seen from the user’s perspective by creating oniy a mask 
image of the Stencii buffer when rendering the inner side of the shadow voiume, and then exciuding the 
mask region when drawing outside the shadow voiume. 

Shadow poiygons used for masks and rendering can be differentiated by their poiygon IDs. 


Polygon ID 

Classification 

0 

Shadow polygons for masks 

1-63 

Shadow polygons for drawing 


Figure 7-33 iiiustrates the concept of shadow poiygons. " Figure 7-34 : When Drawing a Shadow Poivaon 
for a Mask " on page 264 describes rendering shadow poiygons for masking. " Figure 7-34 : When Drawing 
a Shadow Poiygon for a Mask " on page 264 describes rendering shadow poiygons for drawing. 

The procedure for attaching shadows using shadow poiygons is as foiiows: 


1. Set rendering order 

Because both mask- and draw-shadow polygons must be translucent and must exist in the drawing order (see the 
"Cautions" on pace 2651 . set the translucent polygons to manual sort with SwapBuffers and set them to be 
rendered in the order they are transmitted to the Geometry Engine. 

2. Draw the shadow polygon for the mask 

Set the polygon attributes to [Draw only the back surface], [ID = 0], [a = 1 - 30] and [Shadow polygon] and draw the 
mask-shadow polygon. The rendering engine does not update the color buffer and creates only the mask Images 
with 1 set in the stencil buffer. 

3. Draw the shadow polygon for rendering 

Next, set the polygon attributes to [Draw both surfaces], [ID = 1-63], [a = 1-30] and [Shadow polygon] and draw the 
shadow polygons for rendering. The rendering engine first reads the stencil buffer, and if the value Is 1, resets it to 0. 
If the value Is 0, the engine attempts to draw to the color buffer. 

• Polygon ID 

The draw-shadow polygon Is drawn at this time only If Its ID differs from both the ID of the opaque polygon and 
the ID of the translucent polygon In the Attribute buffer. This specification prevents an ob]ect from casting a 
shadow on itself by setting the same polygon ID for both the ob]ect and the draw-shadow polygon. 

When multiple shadows overlap, you can control whether to overlay them by setting them to the same polygon 
ID. 

• Fog Enable Flag 

When a shadow polygon Is rendered, the results of a logical AND operation applied to the fragment's fog 
enable flag and the Attribute buffer's fog enable flag are written to the Attribute buffer. With this feature, it is 
possible to exclude shaded areas from fog. 

(Example: A spotlight can be expressed by excluding an area from black fog.) 
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Shadow Volume 


Figure 7-33: Shadow Volume 


Light Source 



Object that 
Casts Shadow 


Other Ob] 
(Normal Pol 



• Shadow-volume shape 

In principle, the shadow volume takes the shape of a closed 3D shape. Note the "Cautions" on 
page 265 If you plan to use an open 3D shape In order to reduce the number of polygons. 

• Shadow-volume direction 

To create the shadow of a spherical object, a cylinder-shaped shadow volume Is created on the 
straight line defined by the light source and the spherical object. 

• Shadow-volume position 

The cylinder-shaped shadow volume Is located where It cannot be seen from the light source (a place 
not Illuminated by the light of the sphere). 

• Shadow-volume length 

The shadow Is drawn on the surface of the object that Is located Inside the shadow volume. Thus, the 
length of the shadow volume should be long enough to pass through the surface of the object on which 
you want the shadow to be drawn. 
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Stencil buffer calculations 

1. When drawing a shadow polygon for a mask 

The Stencil buffer is set to 1 when the depth test fails without affecting the Color buffer. 

Figure 7-34: When Drawing a Shadow Polygon for a Mask 

Depth Test Result Stencil Buffer Color Buffer 





Other Object (Normal Polygon) 


2. When drawing a shadow polygon for rendering 

If the Stencil buffer is already set to 1, it is reset to 0. When the depth test succeeds, if the polygon ID 
in the attribute does not match the polygon ID of the shadow polygon for rendering, the polygon is 
drawn to the color buffer. 

Figure 7-35: When Drawing the Shadow Polygon for Rendering 


Depth Test Result _Stendl Buffer 

f Not Drawn to Color f TT” 
Buffer if Polygon IDs 
are Same 

Shadow Polygon for ^ 

Rendering (Outside Surface) 


Color Buffer 


Not drawn to Color 
Buffer if depth test fails 


Q 


Object that Casts Shadow 



Drawn to Color buffer 
if Polygon IDs are Different 


Other Object (Nonmal Polygon) 


As the diagrams illustrate, the shadow is drawn to a portion of one side of the shadow polygon for 
rendering. That is why you cannot achieve the effect of directly pasting textures to shadows when texture 


mapping. 
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Cautions 


1. Order for rendering shadow polygons 

To create a single shadow, draw the necessary shadow polygon for the mask and then the shadow 
polygon for rendering. If you draw a collection of shadow polygons for the mask and then draw the 
corresponding collection of shadow polygons for rendering, shadows may not be created in the 
intended regions. 

Correct rendering string: 

Shadow volume for mask 1 ^ Shadow volume for rendering 1 ^ 

Shadow volume for mask 2 ^ Shadow volume for rendering 2 

2. Shadow volumes with open shapes 

When the shadow volume takes the shape of an open 3D shape, a region that has a shadow polygon 
for rendering but not a shadow polygon for the mask may be generated. This results in the creation of 
an incorrect shadow. 

Note that when a shadow volume is clipped, it takes on an open shape. 

Technique 

By following the procedure below, you can create scenes in which shadows are cast on translucent 
polygons. (However, this technique requires more shadow polygons.) 

1. Opaque polygon ^ 

2. Shadow polygon (shadow on opaque polygon) ^ 

3. Translucent polygon on which a shadow is cast (update depth buffer) ^ 

4. Shadow polygon (the shadow on the translucent polygon / polygon ID is the same as in step 2) ^ 

5. Translucent polygon on which the shadow is not cast. 

Figure 7-36 shows a schematic representation. 


Figure 7-36: Technique for Rendering a Shadow on a Translucent Polygon 
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This register is used for toon shading and highiight shading. 

In toon shading and highiight shading, the fragment coior R vaiue is treated as the brightness, and this R 
vaiue (upper 5 bits) is used as the index to reference RGB vaiues from the toon tabie. 

Figure 7-37: Transformations Using a Toon Tabie 
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7.3.4.5.1 Toon Shading 

The fragment color R value is treated as the brightness, and this R vaiue (the upper 5 bits) is used as the 
index to reference RGB vaiues from the toon tabie to set the new fragment coiors. 

The texture coior and the post-tabie-reference fragment coior both have (RsiGsiBs = 5:5:5) number of bits. 
Therefore, before the texture-biending computation is conducted, the foiiowing formuias are used to 
expand the number of bits to (R@:Ge:B@ = 6:6:6). 

R@ = R 5 « 1 (When R 5 is 0) 

R 0 = (R 5 « 1) + 1 (When R 5 is nonzero) 

Texture mapping invoives the same equations used in Moduiation mode, except that the toon tabie- 
transformed vaiues are used for the fragment coiors (see Tabie 7-12). 


Table 7-12 : Texture Blending Equations (toon table) 


Type of Texture 

Translucent Texture 

Non-translucent Texture 

Texture 

Blending 

Equations 

R = { (Rt+1) X (Rs’+I)-1}/64 

G = { (Gt+1)x(Gs’+1)-1}/64 

B = { (Bt+1)x(Bs’+1)-1}/64 

A = { (At+1)x(As+1)-1}/64 

R = { (Rt+1) X (Rs’+I)-1}/64 

G = { (Gt+1)x(Gs’+1)-1}/64 

B = { (Bt+1)x(Bs’+1)-1}/64 

A = At X As 


(R, G, B, A) : Newly written fragment color (fractional parts resulting from calculations are truncated) 

(Rt, Gt, Bt, At) : Texture color expanded to (R:G:B = 6:6:6) bits 

(Rs, Gs, Bs, As) : Fragment color expanded to (R:G:B = 6:6:6) bits 

(Rs’, Gs’, Bs’) : Fragment color expanded to (R:G:B = 6:6:6) bits after table conversion 

Note: The toon table is referenced for fragment colors shared by all toon-shaded polygons. If you want 
every toon shading polygon to have different colors, use textures to color even monochrome 
polygons. 

Using ambient reflection color and emission color to raise the minimum value of the fragment color 
R value also narrows the effective range of R, and this coarsens the gradation of toon shading. 
Because material color loses its meaning when toon shading, we recommend that you use only 
diffusion reflection color so as to retain gradation. 
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7.3.4.5.2 Highlight Shading 

The fragment color R value is treated as the brightness, and this R vaiue (the upper 5 bits) is used as the 
index to reference RGB vaiues (coior offset vaiues) from the toon tabie to add to the fragment coior. 

The texture coior and the post-tabie-reference fragment coior both have (RsiGsiBs = 5:5:5) number of bits. 
Therefore, before the texture-biending computation is conducted, the foiiowing formuia is used to extend 
the number of bits to (Re:Ge:B@ = 6:6:6). 

Rg = Rs « 1 (If Rs is 0) 

Rg = (Rg « 1) + 1 (If Rg is not 0) 

When texture mapping, a coior offset vaiue is added to texture coiors whose RGB vaiues have each been 
moduiated by the fragment coior’s R vaiue (see Tabie 7-13). This can produce an effect as if the texture is 
highiighted (emitting a coior brighter than the texture's own coior). 


Table 7-13 : Texture Blending Equation (Highlight Shading) 


Texture Type 

Translucent Texture 

Non-translucent Texture 

Texture 

Blending 

Equations 

R = mln[ 63, { (Rt+1) x (Rs+1) -1} / 64 + Rs’ ] 

G = mln[ 63, { (Gt+1) x (Rs+1) -1} / 64 + Gs’ ] 

B = mln[ 63, { (Bt+1) x (Rs+1) -1} / 64 + Bs’ ] 

A = { (At+1)x(As+1)-1}/32 

R = mln[ 31, { (Rt+1) x (Rs+1) -1} / 64 + Rs’ ] 

G = mln[ 31, { (Gt+1) x (Rs+1) -1} / 64 + Gs’ ] 

B = mln[ 31, { (Bt+1) x (Rs+1) -1} / 64 + Bs’ ] 

A = At X As 


(R, G, B, A) : Newiy written fragment coior (fractionai parts resuiting from caicuiations are truncated) 
(Rt, Gt, Bt, At) : Texture coior extended to (R:G:B = 6:6:6) bits 
(Rs, Gs, Bs, As) : Fragment coior 

(Rs’, Gs’, Bs’) : Fragment coior extended to (R:G:B = 6:6:6) bits after tabie conversion 
Note: Because a coior offset is added, sometimes the hue of the fragment coior changes. 
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7.3.5 Textures 

7.3.5.1 Texture Blending 

The Rendering Engine interpoiates the texture coordinates corresponding to each pixei inside the poiygon 
using the texture settings (fiip/repeat) passed by the Geometry Engine, the vertex texture coordinates, and 
the MTvaiue. 

The process of biending texei coior with the coior of each pixei of the poiygon is caiied texture biending. 
The mode for this texture biending can be set to either Decai or Moduiation, using the PoiygonAttr register. 

7.3.5.1.1 Texture Image Sampling 

In TWL, the texture image is sampied by interpoiating, from each vertex’s texture coordinates, texture 
coordinates that correspond to the top-ieft of each pixei in a poiygon (see Figure 7-38). 

Figure 7-38: Texture image Sampiing 



For exampie, if a poiygon has 8x8 textures appiied to it and its dispiay width is 14 dots, pixei and texei 
correspondence are as shown on the ieft in Figure 7-39. 

If a polygon is turned front to back like this, the texel/pixel correspondence slips. 

In the diagram on the right of Figure 7-39, texei 0 appears at the left edge (if the texture is not H-flipped, it 
is omitted). On the right edge, texei 0 is only sampled once. 

Figure 7-39: Applying an 8x8 texei Texture to an 14-dot Wide Poiygon 
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If a polygon has 8x8 textures applied to it and its display width is 8 dots, pixel and texel correspondence 
are as shown in Figure 7-40. 

Figure 7-40: Applying an 8x8 texel Texture to an 8-dot Wide Polygon 
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When using polygons for 2D displays such as OBJ or BG, texels and pixels have a one-to-one 
correspondence. However, in a case such as this, when rendering a polygon that is mapped with an 8x8 
texel texture on 8x8 pixels of an LCD, the front and back surfaces are displayed as shown in Figure 7-41. 

Figure 7-41: Displaying Front and Back Surfaces of an LCD 
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7.3.5.1.2 Decal Mode 

Depending on the texture's a value, either the result of Gouraud shading of the vertex color created by the 
lighting process (fragment color) or the texture's color value is displayed. 

For translucent textures, blending is done with the texture's a value. 

Table 7-14 shows the texture-blending expression used in decal mode. 

The texture color has (RsiGsiBs = 5:5:5) number of bits. Therefore, before the texture-blending 
computation is conducted, the following formulas are used to expand the number of bits to (R@:Ge:B@ = 
6 : 6 : 6 ). 


R@ = R 5 « 1 (When R 5 is 0) 

R@ = (R 5 « 1) + 1 (When R 5 is non-zero) 


Table 7-14 : Texture Blending Equations (Decal Mode) 


Texture Type 

Translucent Texture 

Non-translucent Texture 

Texture 

Blending 

Equations 

R = (At x Rt + (31 - At) Rs) / 32 

G = {AtxGt + (31 - At) Gs}/32 

B = (At x Bt + (31 - At) Bs) / 32 

A = As 

Handling exceptions: 

When At = 0, 

(R, G, B, A) = (Rs, Gs, Bs, As) is used. 
When At =31, 

(R, G, B, A) = (Rt, Gt, Bt, As) is used. 

R = At X Rt + (1 - At) Rs 

G = AtxGt + (1 - At) Gs 

B = At X Bt + (1 - At) Bs 

A = As 


(R, G, B, A) : Newly written fragment color (fractional parts resulting from calculations are truncated) 
(Rt, Gt, Bt, At) : Texture color expanded to (R:G:B = 6:6:6) bits 
(Rs, Gs, Bs, As) : Fragment color 
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7.3.5.1.3 Modulation Mode 

The result of the Gouraud shading of the vertex color (fragment color) created by the lighting process is 
moduiated by the texture's coior vaiue and dispiayed. 

Tabie 7-15 shows the texture-biending expressions used in moduiation mode. 

The fragment coiors of texture coiors have (RsiGsiBs = 5:5:5) number of bits. Therefore, before the texture¬ 
biending computation is conducted, the foiiowing formuias are used to expand the number of bits to 
= 6:6:6). 

Rg = Rg « 1 (When Rg is 0) 

Rg = (Rg « 1) + 1 (When Rg is nonzero) 


Table 7-15 : Texture Blending Expressions (Modulation Mode) 


Type of Texture 

Translucent Texture 

Non-Translucent Texture 

Texture 

Blending 

Equations 

R = {(Rt+1)x(Rs+1)-1}/32 

G = {(Gt+1)x(Gs+1)-1}/32 

B = {(Bt+1) x(Bs+1)-1}/32 

A = {(At+1) x(As+1)-1}/32 

R = {(Rt+1)x(Rs+1)-1}/32 

G = {(Gt+1)x(Gs+1)-1}/32 

B = {(Bt+1) x(Bs+1)-1}/32 

A = At X As 


(R, G, B, A) : Newiy written fragment coior (fractionai parts resuiting from caicuiations are truncated) 
(Rt, Gt, Bt, At) : Texture coior expanded to (R:G:B = 6:6:6) bits 
(Rs, Gs, Bs, As) : Fragment coior 
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7.3.5.2 Texture Formats 

TWL can handle seven different texture formats. Table 7-16 lists the texture formats. 


Table 7-16 : List of Texture Formats 


Format 

Number of Selectable 
Colors for 1 Texei 

Palette 

Base 

Boundary (see 
note) 

a Value 
Bits 

Number of Bits per 
Texei 

4-Color Palette Texture 

4 

0x08 

0 

2 

16-Color Palette Texture 

16 

0 x 10 

0 

4 

256-Color Palette Texture 

256 

0 x 10 

0 

8 

4x4 Texei 

Compressed Texture 

4 

(every 4x4 texels) 

0 x 10 

0 

3 

(Includes palette index 
data) 

A3I5 Translucent Texture 

32 

0 x 10 

3 

8 

A5I3 Translucent Texture 

8 

0 x 10 

5 

8 

Direct Color Texture 

32,768 

Palette not 
used 

1 

16 


Note: Palette Base Boundary is the amount by which the address is increased when the paiette base is 
increased by 1 by the TexPlttBase command 

7.3.5.2.1 Texture Images 

The Rendering Engine references the texture image siot's texture image in the format specified by the 
TeximageParam command. The texture image is composed of texei data. 

7.3.5.2.1.1 4-Color Palette Textures 


Texei Data Format 


15 14 

13 12 

11 10 

9 8 

7 6 

5 4 

3 2 

1 0 

T7 

T6 

T5 

T4 

T3 

T2 

T1 

TO 

8 Texels of Data (2 bits / texei) 


• T7-T0 : Texei Data 

Specifies the texture coior paiette coior number (0-3) 

Display Texture 


TO 

T1 

T2 

T3 

T4 

T5 

T6 

T7 






















L. 
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7.3.5.2.1.2 16 Color Palette Textures 

Texel Data Format 


15 


12 11 


T3 

T2 

T1 

TO 

4 Texels of Data (4 bits / texel) 


• T3-T0 : Texel Data 

Specifies the texture coior paiette coior number (0-15). 

Display Texture 


TO 

T1 

T2 

T3 






























7.3.5.2.1.3 256-Color Palette Textures 

Texel Data Format 


15 


T1 

TO 

2 Texels of Data (8 bits / texel) 


• T1-T0 : Texei Data 

Specifies the texture coior paiette coior number (0-255). 

Display Texture 


TO 

T1 
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7.3.5.2.1.4 4x4 Texel Compression Textures 

This format can obtain the compression effect by dividing the image into 4x4 pixei biocks and then 
converting them to images with paiettes with 2-bit indexes. 

Texel Data Format 


31 24 

23 16 

15 8 

7 0 

T33 

T32 

T31 

T30 

T23 

T22 

T21 

T20 

T13 

T12 

T11 

T10 

T03 

T02 

T01 

TOO 

4x4 Texels of Data (2 bits / texel) 


• T33-T00 : Texei Data 

Specifies the coior number (0-3). 


Display Texture 


TOO 

T01 

T02 

T03 





T10 

T11 

T12 

T13 





T20 

T21 

T22 

T23 





T30 

T31 

T32 

T33 
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Palette Index Data Format 


15 


14 


13 


A 

PTY 















Palette Settings 

Palette Address 


• Palette settings 

• A : 3 colors / 4 colors setting flag 


0 

3 colors + Transparent mode 
(Color 3 is transparent color) 

1 

4-color mode 


• PTY : Palette type selection flag 


0 

4-color palettes 

(Four palettes for each 4x4 texels) 

1 

Linear interpolation 4-color palettes (Two palettes for each 
4x4 texels) 


• Palette address 

The address of the texture palette slot in which color data is stored is specified in units of 2 colors 
(units of 4 bytes). 

Color 0 is the color located at the texture palette slot address, calculated as follows: 

(The value set by the TexPIttBase command x 0x10) + (the palette address setting value x 4) 

The texel color value RGB components are calculated as shown in Table 7-17. 


Table 7-17 : Texel Color Values 




PTY=0 

PTY=0 

A=0 

Color 0[5:0]:(Palette 0[4:0]==0) ? (Palette 0[4:0] x 2) : (Palette 0[4:0] x 2 + 1) 

Color 1[5:0]:(Palette 1[4:0]==0) ? (Palette 1[4:0] x 2) : (Palette 1 [4:0] x 2 + 1) 

Color 2[5:0]:(Palette 2[4:0]==0) ? (Palette 2[4:0] x 2) : (Palette 2[4:0] x 2 + 1) 

Color 3(5:0]:Transparent Color 

A=1 

Color 0[5:0]:(Palette 0[4:0]==0) ? (Palette 0(4:0] x 2) : (Palette 0[4:0] x 2 + 1) 

Color 1[5:0]:(Palette 1[4:0]==0) ? (Palette 1[4:0] x 2) : (Palette 1 [4:0] x 2 + 1) 

Color 2[5:0]:(Palette 2[4:0]==0) ? (Palette 2(4:0] x 2) : (Palette 2(4:0] x 2 + 1) 

Color 3(5:0]:(Palette 3(4:0]==0) ? (Palette 3(4:0] x 2) : (Palette 3(4:0] x 2 + 1) 

PTY=1 

A=0 

Color 0(5:0]:Palette 0(4:0] x 2 

Color 1[5:0]:Palette 1(4:0] X 2 

Color 2[5:0]:Palette 0(4:0] + Palette 1(4:0] 

Color 3(5:0]:Transparent Color 

A=1 

Color 0(5:0]:Palette 0(4:0] x 2 

Color 1[5:0]:Palette 1(4:0] X 2 

Color 2[5:0]:(Palette 0(4:0] x 5 + Palette 1(4:0] x 3) / 4 

Color 3(5:0]:(Palette 0(4:0] x 3 + Palette 1(4:0] x 5) / 4 


One set of palette index data is associated with each 4x4 texel (see " Figure 7-42 : Texture Image Slots " on 
page 277). 
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Texture Image Slots 

In 4x4 texel compression mode, the texture image data and the texture paiette index data shouid be 
mapped as foiiows: 

• Texei data 

Map to texture image siots 0 and 2. 

• Texture paiette index data 
Map to texture image siot 1. 

• Correspondence between texei data and texture paiette index data 

The texture paiette index data that corresponds to the 4x4 texei data in the TIAa address of texture 
image siot 0 shouid be piaced in the (TIAa/2) address of texture image siot 1. 

The texture paiette index data that corresponds to the 4x4 texei data in the TlAb address of texture 
image siot 2 shouid be piaced in the (0x10000 + (TIAb/2)) address of texture image siot 1. (See Figure 
7-42.) 

Each 4x4 texei is associated with one set of texture paiette index data. Individuai texei coiors take the 
coior of the address (the texture coior paiette siot) specified by the texture paiette index data as 0 and 
use the coior number’s coior designated by the texei data. 

Figure 7-42 : Texture Image Slots 
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Note: Texture data is piaced in siot 0 and siot 2. Because the address jumps, it is not possibie to 

reference 1024x1024. In 4x4-texel compressed-texture mode, use a texture size that is no iarger 
than 1024x512. 
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7.3.5.2.1.5 A3I5 Translucent Textures 

Texel Data Format 


15 13 12 8 

7 5 4 0 

ALPHA 

INDEX 

ALPHA 

INDEX 

T1 

TO 


• T1-TO : Texel data 
• ALPHA : a-value 

Specifies that the degree of transparency for the texei. 0 is Transparent. 

The a-vaiue is used in the Rendering Engine, extended in 5 bits as shown in the tabie beiow. 
(5-bit a = {(3 bit a « 2) -I- (3 bit a » 1)}) 


3 bit a 

0 

1 

2 

3 

4 

5 

6 

7 

5 bit a 

0 

4 

9 

13 

18 

22 

27 

31 


• INDEX : Coior number 

Specifies the coior number (0-31) of the texture coior paiette. 

Display Texture 


TO 

T1 
































7.3.5.2.1.6 A5I3 Translucent Textures 

Texel Data Format 


15 11 10 8 

7 3 2 0 

ALPHA 

INDEX 

ALPHA 

INDEX 

T1 

TO 


• T1-TO : Texei data 

• ALPHA : a-vaiue 

Specifies that the degree of transparency for the texei. 0 is Transparent. 

• INDEX : Color number 

Specifies the color number (0-7) of the texture color palette. 


Display Texture 


TO 

T1 
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7.3.5.2.1.7 Direct Color Textures 

Texel Data Format 



• TO : Texel data 

Directly configures texei coior. The texture coior paiette is not used. 

Display Texture 


TO 
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7.3.5.2.2 Texture Palette 

The texture palette slot stores the texture color data. 

Texture Color Data Format 


15 14 13 12 11 10 9 8 I 7 6 5 4 3 2 1 0 



TEX_COLOR_BLUE 

TEX_COLOR_GREEN 

TEX_COLOR_RED 


Color 


The texture format determines the way in which texture coior paiettes are referenced. (The texture formats 
are: 4-coior, 16-coior, 256-coior, 4x4 compressed-texei, A3I5, and A5I3.) 

Generaiiy, the coior number is referenced for the coior determined by the texei data from the paiette specified 
by the texture paiette base. However, when the texture is a 4x4 compressed-texei-format texture, the paiette 
is specified by setting the paiette address, in addition to the texture paiette base. See Figure 7-43 to Figure 7- 
46 for detaiis on the paiette base for each texture coior paiette and paiette address mapping. 

Figure 7-43: Palette Base and Palette Address (4-color palette) 
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Figure 7-44: Palette Base and Palette Address (16-Color Palette and 256-Color Palette) 
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Figure 7-45: Palette Base and Palette Address (4x4 Texel Compression) 
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For a 4x4 compressed-texel-format texture, the palette address is set by the palette base and the palette 
address. Color numbers 0 to 3 are referenced for a four-color palette, but only color numbers 0 and 1 are 
referenced for a linear interpoiated four-coior paiette. The remaining two coiors appiied to the texeis are 
caicuiated from Coior 0 and Coior 1. 

Even for a four-coior paiette. Transparent is used without referencing Coior 3 when the mode is set to 
Three Coiors -i- Transparent. 

Figure 7-46: Palette Base and Palette Address (A3I5, A5I3) 
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7.3.6 Alpha-Test 

After texture blending, the fragment's alpha value is compared with the vaiue set in the AiphaReference 
register. Rendering does not occur when the a vaiue is iess than this reference vaiue. 

AiphaReference: Alpha-Test Comparison Value Register 

Name: ALPHA TEST REF Address: 0x04000340 Attribute: W Initial value: 0x0000 


15 













ALPHA_REFERENCE 












a-Test Comparison Value 


• ALPHA_REFERENCE[d04-d00] : a-Test comparison vaiue 

When a-Test is set to ON, pixeis that have an a vaiue beiow this specified vaiue are not drawn. 

• Wireframe dispiay poiygons 

Setting a = 0 in the poiygon attributes dispiays poiygons as wireframes—a no ionger retains its 
originai meaning. 

If transiucent textures are unmapped, the wireframe section actuaiiy has an a vaiue of 31. 

Therefore, if the a test reference ievei is set when the a test is ON when dispiaying a wireframe, it is 
dispiayed for any reference vaiue other than 31. 

7.3.7 Alpha-Blending 

The specifications caii for the Rendering Engine to perform aipha-biending by first creating the 3D screen 
before aipha-biending with the 2D screen. Aipha-biending with the 2D screen is performed using the 2D 
graphics coior speciai effect functions. 

You can controi the Rendering Engine's aipha-biending process by setting the DISP3DCNT register's 
a-biending enabie fiag on/off. 

Tabie 7-18 shows the equation used when aipha-biending. 


Table 7-18: Equation when a-Blending 


a-Blending Enable Flag 

Calculations for Newly Stored Data in Color Buffer 

When ON 

R = {{As + 1) X Rs + (31 - As) X Rb) / 32 

G = {(As + 1) X Gs + (31 - As) X Gb) / 32 

B = {{As + 1) X Bs + (31 - As) X Bb) / 32 

A = max{As, Ab] 

Handling exceptions: 

When As = 0, (R, G, B, A) = (Rb, Gb, Bb, max[As, Abj) is used. 

When As = 31 or Ab = 0, (R, G, B, A) = (Rs, Gs, Bs, max{As, Abj) is used. 

When OFF 

When As = 0 

(R, G, B, A) = (Rb, Gb, Bb, Ab) 

When As is non-zero 
(R, G, B, A) = (Rs, Gs, Bs, As) 


(R, G, B, A) : Newiy written fragment coior (fractionai parts resuiting from caicuiations are truncated) 
(Rb, Gb, Bb, Ab) : Coior buffer's coior 
(Rs, Gs, Bs, As) ; Fragment coior 
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7.3.7.1 3D Alpha-Blending 

The color buffer's color value and the fragment's color value are blended based on the fragment's a value, 
and the result Is then written back to the color buffer. 

7.3.7.2 2D and 3D Alpha-Blending Preprocess 

In the 3D alpha-blending process described above, the color buffer's a value Is updated only when It Is 
smaller than the fragment's a value. This specification Is set In order to approximate the a value In regions 
where translucent polygons overlap when alpha-blending 2D and 3D. 

When the color buffer's alpha value Is 0 and translucent polygons are drawn, the fragment's color Is written 
to the color buffer without any alpha-blending. 

You can thus achieve a more natural composite with the 2D screen by using ClearColor to zero-clear the 
color buffer's alpha value, since the ClearColor's RGB values are not blended. 

Refer to " 7.4.4.1 Alpha-Blending with the 2D Screen " on page 295 for details on this subject. 

7.3.8 Edge Marking 

Edge marking Is a feature for outlining the edges of opaque polygons with different polygon IDs In the 
Attribute buffer. You can control this feature by setting the DISP3DCNT register's edge-marking enable flag 
on or off. 

The colors that are used In edge marking are the eight colors that are selected using the upper 3 bits of the 
polygon ID as an Index. 


Name 


EdgeColor: Edge Color Register 

Address 


Attribute Initial Value 


EDGE_COLOR_x (x =0-3) 0x04000330, 0x04000334, 0x04000338, 0x0400033C 


W 


0 x00000000 


31 30 


26 25 24 23 


21 20 


16 


15 14 


10 9 8 7 


5 4 



BLUEnI 

GREEN n1 

RED n1 


BLUE nO 

GREEN nO 

RED nO 


Edge marking color when polygon ID (n1)=2x+1 


Edge marking color when polygon ID (n)=2x 


• [d30-d16], [d14-d00] : Edge marking colors 

Specifies the eight colors to employ for edge marking. 

If a polygon Is clipped, edge marking Is also applied to the clipping boundary (a new edge created by 
clipping) A comparison to clear polygon ID Is also made at the edge of the screen. Therefore, If the 
clear polygon ID and the polygon ID are the same, edge marking Is not applied to the new edges 
created by clipping. 

Note: Edge marking of opaque polygons In the background behind translucent polygons sometimes 
does not work correctly when the PolygonAttr command has set the Translucent Polygon 
Depth Value Update-enable flag to 1 (because the Depth buffer's value Is referenced when 
determining edge marking). 
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7.3.9 Fog Blending 

Fog blending is the process of blending each pixel color with fog color in proportion to the depth value. The 
fog-blending process can create a fog effect on the screen, hiding from the player the far-plane clipping- 
and-rejection processes that do not arise in the natural world. You can control this feature by setting the 
DISP3DCNT register's fog-enable flag on or off. 

7.3.9.1 3D Fog 

In OpenGL, the fog process is performed on each polygon when it is drawn. But with TWL, the fog process is 
performed on the color buffer in which all polygons have been drawn after the edge marking process. 

Because of this specification, you can produce effects in which fog is applied to everything except a 
specified region. However, applying fog to regions in which translucent polygons are rendered can produce 
unnatural effects. If this happens, use the PolygonAttr command to set the Translucent Polygon Depth 
Value Update-enable flag for visual approximation. 

Note: If you update the depth value, you must also conduct a Z sort, or else some parts inside regions in 
which translucent polygons overlap may not be rendered. 

FogColor: Fog Color Register 

Name: FOG COLOR Address: 0x04000358 Attribute: W Initial value: 0x00000000 



This specifies the fog color. 


When compositing with the 2D screen's background, you can achieve the effect of the object’s dissolving 
into the 2D screen if you set the fog a value to 0. This effect appears more natural if you set the Fog mode 
of the 3D Display Control register (DISP3DCNT) to Fog Blending Using only the Pixel’s a Value. 


FogOffset: Fog Offset Register 

Name: FOG OFFSET Address: 0x0400035C Attribute: W Initial value: 0x0000 



• FOG_OFFSET[d14-dOO] : Fog offset 

Sets the depth value that is the basis for fog density calculations. 

The fog density for pixels that have an upper 15-bit depth value nearer than (fog offset + (0x400 » fog 
shift)) is fixed to the fog density table's DENSITYO value. The fog density for pixels that have a depth 
value farther than (fog offset + (0x400 » fog shift) x 32) is fixed to DENSITY31. 

The fog shift is a value set by the DISP3DCNT register (the 3D Display Control register). 

If the depth value is within the two areas mentioned above, the fog density is the value that results 
from linear interpolation of two elements in the fog table. 

Because the depth value differs depending on the method of depth buffering (Z buffering or W 
buffering), the way in which fog is applied also differs. In short, the fog density depends on the depth- 
value curve to the z value of the View coordinates. To learn more about this relationship, see "7.2.5 
Depth Buffering" on page 187 . The method for depth buffering is selected using the Geometry 
Engine's SwapBuffers command. 
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FogTable: Fog Density Table Register 


Name 


FOG_TABLE_x (x=0-7) 


Address 


Attribute Initial Value 


0x04000360,0x04000364,0x04000368, 0x0400036C, 
0x04000370, 0x04000374, 0x04000378, 0x0400037C 


W 0x00000000 


31 30 24 

23 22 16 

15 14 8 

7 6 0 


DENSITY n3 


DENSITY n2 


DENSITY n1 


DENSITY nO 


Fog Density n3=4x+3 


Fog Density n2=4x+2 


Fog Density n1=4x+1 


Fog Density n0=4x 


Specifies a 32-ievei fog density tabie. 

The fog density for each pixei is the vaiue that resuits from iinear interpoiation of the corresponding depth 
buffer vaiue. You can thus approximate any fog density curve (see " Figure 7-47 : Depth Vaiues and Fog 
Density " on page 287). 

7.3.9.1.1 Fog Density Equations 

Assume that FJVL = (0x400 » FOG_SHIFT) and that f(i) is the parameter in the fog density tabie. 
Then the fog density and the upper 15-bit depth vaiue (Zd) have the foiiowing reiationship: 

1. When 0x0000 < Zd < (FOG_OFFSET -h F_IVL - 1): 

Fog density f = f (0) 

2. When (FOG_OFFSET -h FJVL x i) < Zd < (FOG_OFFSET -h F_IVL x (i -h 1 ) -1) (i = 1-31): 

Fog density f = 

{f(i)-f(i-l)}x{Zd-(FOG_OFFSET + F_IVLxi)} ^ 

^ F_IVL 

3. When FOG_OFFSET -h FJVL x 32 < Zd < 0x7FFF: 

Fog density f = f (31) 
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Figure 7-47: Depth Values and Fog Density 



The fog shift is set by the DISP3DCNT register (the 3D Dispiay Controi register). 
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Table 7-19 shows the fog-blending equations. 


Table 7-19: Fog-Blending Equations 


Fog Mode 

Fog Blending with Pixel's Color and a Value 

Fog Blending only with Pixel's a Value 


R = {fxRf+ (128-f)xRs}/128 

R = Rs 


G = {fxGf+ (128-f )xGs}/128 

G = Gs 

Fog 

Blending 

B = {fxBf + ( 128-f) X Bs}/128 

B = Bs 

A = {f xAf + ( 128-f )x As}/128 

A = {fxAf + ( 128-f )xAs}/128 

Equations 

Flandling exceptions: 

Handling exceptions: 


Whenf = 127, 

(R, G, B, A) = (Rf, Gf, Bf, Af) is used 

When f = 127, A = Af is used 


(R, G, B, A) : Newly written fragment color (fractional parts resulting from calculations are truncated) 

(Rf, Gf, Bf, Af) : Fog color 

(Rs, Gs, Bs, As) : Color in the color buffer after edge marking 

7.3.9.2 Fog Preprocessing for 2D 

If fog is disabled, the region in which the color buffer's a value is zero-cleared is treated as an alpha cut¬ 
out region when compositing with the 2D screen. From this region, you can see the unmodified color of the 
2D screen in the background. (See "7.4 2D Graphics Features You Can Apply to the 3D Screen After 
Rendering" on page 293 .1 

If, on the other hand, fog is enabled, this otherwise transparent region is also subject to fog blending, and 
the color buffer value is updated. Afterwards, the 2D color special-effect feature (2D and 3D alpha¬ 
blending) can work to alpha-blend the color buffer and the 2D screen, so fog is also applied to the 2D 
screen in the background seen from this region. 

In this way, 2D fog blending is conducted via 2D and 3D alpha-blending. (See "7.3.7.2 2D and 3D Alpha- 
Blendino Preprocess" on pace 284 .') 
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7.3.10 Anti-Aliasing 

The anti-aliasing feature biends an edge section in the front buffer with the coior in the back coior buffer. 
The front coior buffer hoids the rendered resuits of the front poiygon; the back buffer stores the rendered 
resuits of aii poiygons (inciuding ciear coiors) that are behind the front poiygon. Anti-aiiasing is oniy appiied 
to the edges of opaque poiygons. Anti-aiiasing uses the a vaiue that is newiy written into the coior buffer 
as a biending factor when aipha-biending with 2D. Therefore, even a 2D background exhibits the anti- 
aiiasing effect. 

Tabie 7-20 shows the anti-aiiasing equations. 

Figure 7-48 iiiustrates the concept of anti-aiiasing. Figure 7-49 shows the edge that is output to the LCD. 


Table 7-20: Anti-Aliasing Equations 



Anti-aliasing Equations 

A2 at least 1 

RA = {( AC + 1) X R1 + ( 31 - AC) X R2 } / 32 

GA = {(AC + 1)xG1 +(31 - AC)xG2}/32 

BA = {( AC + 1) X B1 + ( 31 - AC) X B2 } / 32 

AA = {(AC + 1)x31 +(31-AC)xA2}/32 

A2 = 0 

RA = R1 

GA = G1 

BA = B1 

AA = {(AC + 1)x31 }/32 


(RA, GA, BA, AA) : Coior newiy stored in the coior buffer (fractionai parts resuiting from caicuiations are 
truncated). 

(R1, G1, B1,31) : Coior in the front coior buffer (aipha = 31 since the anti-aiiasing target is an opaque 
polygon). 

(R2, G2, B2, A2) : Color in the back coior buffer 
AC : Anti-aiiasing factor (5 bits) 

The anti-aiiasing factor is appiied proportionateiy to the surface area of the pixei occupied by the poiygon. 
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Figure 7-48: Anti-Aliasing 



Front Polygon 
Rear Polygon 
Clear Color 

2D Surface Color of the Second Target Screen 
Color with anti-aliasing of RGB 




Front Color Buffer 



Back Color Buffer 



I 


J 


Anti-Aliasing 


When Clear a is 0 





When Clear a Is 1 or greater 



2D Surface of Second Target Screen 


a-Blending with 2D Surface 
'V 
LCD 
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Figure 7-49: Final LCD Image Output (Anti-Aliasing) 



Figure 7-49 shows the visual image. Table 7-21 shows the actual RGB results 


Table 7-21: Anti-Aliasing and Alpha-Blending with a 2D Surface 


A2 

a Blending 
with 2D 
Surface 

Anti-aliasing Resuits 
(RGBA) 

Resuit of a Blending with 2D Surface 
(RGB) 

Edge 

Background 

Edge 

Background 

0 

No 

(Rl, G1, B1, AA) 

(R2, G2, B2, 0) 

(Rl, G1, B1) 

Color of 2D surface 

0 

Yes 

(Rl, G1, B1, AA) 

(R2, G2, B2, 0) 

OC-blended color of (Rl, G1, B1) 
and 2D surface 
(a-blending factor AA) 

Color of 2D surface 

1 or 
More 

No 

(RA, GA, BA, AA) 

(R2, G2, B2, A2) 

(RA, GA, BA) 

(R2, G2, B2) 

1 or 
More 

Yes 

(RA, GA, BA, AA) 

(R2, G2, B2, A2) 

OC-blended color of (RA, GA, BA) 
and 2D surface 
(a-blending factor AA) 

a-blended result of (R2, 
G2, B2) and 2D surface 
(a-blending factor A2) 


Because the interior of a polygon is opaque (alpha = 31), there is no alpha-blending with the 2D. 
Therefore, this case is omitted. 


Table 7-21 shows how, when A2 is 0, anti-aliasing is applied only to alpha values. RGB color is written to 
the color buffer as is, with no blending. 

In this case, do alpha-blending with the 2D surface and reflect this in RGB. (The alpha value from anti¬ 
aliasing is applied to alpha-blending. 
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7.3.11 Status 


Rendered Line Count Register 

Name: RDLINES COUNT Address: 0x04000320 Attribute: R Initial value: 0x0000 


15 












RENDERED_LINES_MIN 











Minimum value for number of rendered lines 


• RENDERED_LINES_MIN[d05-d00] : Minimum vaiue for number of rendered iines (0-46) 

Use this to check the minimum number of iines in the coior buffer during dispiay of the previous frame. 
This register is updated during every V cycie. The coior buffer hoids 48 iines, but 2 iines are the current 
buffer, so the iargest count-vaiue for this register is 46. You cannot confirm from this vaiue whether or 
not iines have overfiowed, but you can determine the risk of this happening. To determine whether or 
not iines have overfiowed, check the Coior Buffer Underfiow Fiag of the 3D Dispiay Controi register 
(DISP3DCNT). 

Note: When the counter reaches 0, there is a risk that the Rendering Engine wiii faii to draw iines 
(that is, iines wiii overfiow). When the counter approaches 0, reduce the ioad on the Rendering 
Engine by, for exampie, reducing the number of poiygons sent to the Geometry Engine. 

Comparison of Rendering Buffer Methods 

• Normal frame-buffer method 

In this method, there are two or three frame buffers for rendering and dispiay, and the buffers are 
swapped during the V-Biank period immediateiy after drawing is compieted. If there are more 
rendering poiygons and pixeis than the rendering engine can process, the frame rate drops due to 
rendering deiays. 

• FIFO line-buffer method adopted by TWL 

In this method, drawing and dispiay invoive the same FIFO buffer. This FIFO buffer has a capacity of 
48 iines. During dispiay, data is read from the FIFO buffer in sync with the timing of the LCD. Data for 
the horizontai direction is read with the dot ciock, whereas data for the verticai direction is read in the 
horizontai scanning intervai (355-dot ciocks). If there are more polygons and pixels for the line to be 
drawn than the Rendering Engine can process, the display is corrupted because the Rendering Engine 
cannot render it in time. 
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7.4 2D Graphics Features You Can Apply to the 3D Screen After Rendering 

In TWL, the 3D screen is displayed as BGO after it has been rendered, rather than being displayed directly 
on the LCD. This enables certain 2D graphic features to also be applied and displayed on the LCD. To read 
the basic specifications for 2D graphics see "6 2D Graphics" on page 97 . 

7.4.1 Raster Scroll 

Unlike 2D screens, 3D screens cannot be scrolled vertically. However, they can be scrolled horizontally. 

BGO Offset Settings Register 

Name: BGOOFS Address: 0x04000010 Attribute: W Initial value: 0x0000 


15 









SH 

INTEGER_H 








H Offset 


Signed fixed-point number (sign + 8-bit integer) 

• H[d08-d00] : H offset 

Changes the starting position of display in the horizontal direction. 

Unlike for 2D screens, d08 is the sign bit, and the offset value can be set in the range of -256 to -1-256. 

Portions of the display screen that go beyond the screen because of horizontal scrolling become 
transparent. (See Figure 7-50.) 

Figure 7-50: H Offset for a 3D Surface 

H Offset 

^ 3D BGO Screen 
□ Display Image 

Transparent Display 



7.4.2 Order of Display Priority with a 2D Screen 

BGO Control Register 

Name: BGOCNT (x=0, 1) Address: 0x04000008 Attribute: R / W Initial value: 0x0000 


15 


1 0 
































Order of Priority 


By adjusting the display priority, you can place the 2D screen either in front of or behind the 3D screen. 
See the diagram in " 6.9 Display Priority " on page 175. 
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7.4.3 Windows 

You can apply windows to BGO of the 3D screen. 

Window Position Settings Register 

Name: WINxH (x=0, 1) Address: 0x04000040, 0x04000042 Attribute: W Initial value: 0x0000 


15 8 7 0 



Window's upper-left X coordinate Window's lower-right X coordinate 


Name: WINxV (x=0, 1) Address: 0x04000044, 0x04000046 Attribute: W Initial value: 0x0000 
I 15 8 I 7 0 I 



Window's upper-left Y coordinate Window's lower-right Y coordinate 


Name: WININ 
I 15 


Window Inside Control Register 

Address: 0x04000048 Attribute: R / W Initial value: 0x0000 


EFCT 

OBJ 

BG3 

BG2 

BG1 

BGO 


EFCT 

OBJ 

BG3 

BG2 

BG1 

BGO 


Window 1 Inside 


Window 0 Inside 


Name: WINOUT 


Window Outside Control Register 

Address: 0x0400004A Attribute: R / W 


Initial value: 0x0000 


EFCT 

OBJ 

BG3 

BG2 

BG1 

BGO 


EFCT 

OBJ 

BG3 

BG2 

BG1 

BGO 


OBJ Window Inside 


Window (0, 1 and OBJ Window) Outside 


If the 3D screen has highest priority, a-biending is aiways enabied, regardiess of the setting for the 
Window Controi register's coior-effect enabie fiag. 
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7.4.4 Color Effects 

For details on each register parameter, see the Color Special Effects Register in 2D Graphics. 

7.4.4.1 Alpha-Blending with the 2D Screen 

The alpha-blending feature of 2D color effects is used for post-processing after the 2D and 3D alpha¬ 
blending process and the 2D fog process. To read about preprocessing, see "7.3.7.2 2D and 3D Alpha- 
Blending Preprocess" on page 284 and "7.3.9.2 Fog Preprocessing for 2D" on page 288 . 

Color Effect Control Register 

Name: BLDCNT Address: 0x04000050 Attribute: R / W Initial value: 0x0000 


15 


13 




BD 

OBJ 

BG3 

BG2 

BG1 

BGO 

0 

1 

BD 

OBJ 

BG3 

BG2 

BG1 

BGO 



Second Target Screen 

Selected Effect 

First Target Screen 


• [d07-d06] : Selected effect 

Perform alpha-blending by setting [d07] to 0 and [d06] to 1. 

The process involved when alpha-blending the 3D screen and the 2D screen differs, depending on the 
relative priority of the two screens. When the 2D screen is the first target screen, the value set in the 
BLDALPFIA register is used for alpha-blending, as per the specifications. Flowever, when the 3D 
screen is the first target screen, alpha-blending with the second target screen is performed using the 
alpha value that is being rendered to the color buffer (that is, alpha-blending is done in units of pixels). 

Note: Any part with a color buffer alpha value of 0 is handled in the same way as a 2D cut-out region, 
and thus is not subjected to alpha-blending. Any part with a color buffer alpha value of 1 or more is 
subjected to alpha-blending. 

Color Special Effect / Alpha-Blending Factors Register 

Name: BLDALPFIA Address: 0x04000052 Attribute: R / W Initial value: 0x0000 


15 


12 





















EVB 




EVA 


The factors used for the alpha-blending process are set by EVA and EVB in the BLDALPHA register. (EVA 
and EVB values that are 16 or above are treated as 16.) 
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7.4.4.2 Shininess Up/Down 


Name: BLDCNT 


Coior Effect Controi Register 

Address: 0x04000050 Attribute: R / W 


Initial value: 0x0000 


15 


13 




BD 

OBJ 

BG3 

BG2 

BG1 

BGO 

1 


BD 

OBJ 

BG3 

BG2 

BG1 

BGO 



Second Target Screen 

Selected Effect 

First Target Screen 


• [d07-d06] : Selection of color special effects 

Perform a process to change the shininess by setting [d07] to 1. 

When [d06] is set to 0, shininess is increased. When [d06] is set to 1, shininess is decreased. 

Aii zeros must be set for the second target screen. 

Coior Speciai Effect / Change Shininess Factor Register 

Name: BLDY Address: 0x04000054 Attribute: W Initial value: 0x0000 


15 





























EVY 


The factor used for changing shininess is set by EVY in the BLDY register. (EVY vaiues that are 16 or 
above are treated as 16.) 
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8 DMA 

DMA is a high-speed data-transfer method that bypasses the CPU. It is controiied by the DMA Controiier. 
The ARM9 bus on the TWL has four NITRO-compatibie DMA channeis (DMAO - 3), and there are four 
new DMA channeis (NDMAO-3) that are equipped with new features such as seiecting an arbitration 
method between DMA, giving a totai of eight DMA channeis. (The ARM7 bus aiso has eight channeis.) 

The highest priority channei is DMAO, foiiowed by DMA1, DMA2, and DMA3, in order of priority. For 
NDMA, the highest priority channei is NDMAO, foiiowed by NDMA1, NDMA2, and NDMA3. However, when 
using the round-robin method for arbitration, ownership rights on the bus circuiates around, so the reiative 
priorities among NDMAO-3 no ionger appiy. 

If a higher-priority DMA is activated whiie a iower-priority DMA is executing, the iower-priority DMA pauses, 
and the higher-priority DMA is executed. After the higher-priority DMA is finished, the iower-priority DMA 
resumes execution. Because DMA execution can be paused, consider giving higher priority to DMA 
transfers that must finish within a iimited time frame. 

However, when the CPU is operating with DMA, RAM outside the TCM or cache cannot be accessed. 

Therefore, in the intervai untii the DMA finishes, an interrupt is deiayed when processing anything other 
than TCM. 

8.1 NITRO-Compatible DMA 

The NITRO-compatibie DMA is unchanged from NITRO except for circuit revisions for when muitipie DMA 
channeis are started in paraiiei. 

DMAxSAD: DMAx Source Address Registers (x = 0 - 3) 

Name Address Attribute Initial Value 

DMAxSAD (X =0 - 3) 0x040000B0, 0x040000BC, 0x040000C8, 0x040000D4 R/W 0x00000000 


31 


27 


24 


23 


16 


15 


□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

■ 

■ 

■ 

■ 

DMA Source Address 


DMAxDAD: DMAx Destination Address Registers (x = 0 - 3) 

Name Address Attribute Initial Value 

DMAxDAD (x =0 - 3) 0x040000B4, 0x040000C0, 0x040000CC ,0x040000D8 R/W 0x00000000 


31 


27 


24 


23 


16 


15 


□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

■ 

■ 

■ 

■ 

DMA Destination Address 
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DMAxCNT: DMAx Control Registers (x=0 to 3) 

Name Address Attribute Initial Value 

DMAxCNT (x =0 - 3) 0x040000B8,0x040000C4,0x040000D0,0x040000DC R/W 0x00000000 


31 30 29 


27 26 25 24 23 22 21 20 




• E[d31]: DMA enable flag 


0 

Disable 

1 

Enable 


• I[d30]: Interrupt request enable flag 


0 

Disable 

1 

Enable 


• MODE[d29-d27]: Options for DMA start mode 


000 

Start Immediately 

001 

Start at V-Blank 

010 

Start at FI-Blank 

(DMA does not start during an H-Blank within a V-Blank period) 

oil 

Synchronize to start with display 

(that Is, synchronized to start as each horizontal line Is drawn) 

100 

Main memory display 

101 

TWL / DS Game Card 

110 

Game Pak 

111 

Geometry Command FIFO 


• SB[d26]: Transfer bit-count seiection 


0 

16 bits 

1 

32 bits 
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• CM[d25]: Repeat mode selected flag 


0 

Not Repeat mode 

1 

Repeat mode 


• SAR[d24-d23]: Options to update source address 


00 

Increment 

01 

Decrement 

10 

Fixed 

11 

Setting prohibited 


• DAR[d22-d21]: Options to update destination address 


00 

Increment 

01 

Decrement 

10 

Fixed 

11 

Increment/reload 


• WORD_COUNT[d20-dOO]: Word count 
Specifies the number of transfers. 

• Repeat mode 

When the DMA repeat mode is on, DMA starts automaticaiiy each time the start mode conditions 
occur. 

If the repeat mode is not set, DMA stops when the transfer of the word count voiume is compiete. 

To cancei repeat mode, set the DMA enabie fiag to 0, as described in Step 2 in the procedure beiow. 

• Address update method 

The detaiis of processing the address update method are shown in Tabie 8-1. 


Table 8-1 : Processing Details for the Address Update Method 


Address Update Method 

Process 

Increment 

The address value increases one unit with each transfer 

Decrement 

The address value decreases one unit with each transfer 

Fixed 

The address stays fixed 

Increment/Reload 

Increments for each transfer, and then returns to the transfer’s 
starting address when the transfer of the word count is done 


Note: Setting the address update method to fixed or decrement is prohibited if the source or destination 
is set to Game Pak space because the hardware does not support it. 
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• DMA Start Mode 

Main Memory Display Start Mode 

Do not set the DMA source address to any memory region outside of main memory in Main Memory 
Display Mode. Also, be sure to set the transfer bit mode to 32-bit and the word count value to 4. 

Geometry Command FIFO Start Mode 

When the Geometry Command FIFO is less than half full, DMA starts and 112 words (see the 
procedure below) are transferred. The process repeats until the volume transferred reaches the word 
count value. 

Note: If commands have been packed, the number of words sent in each repetition equals the num¬ 
ber of words before unpacking. 

• Cautions When Starting and Stopping DMA 

1. When starting DMA 

A delay of 2 cycles of the system clock (33.514 Mhz) occurs from the time the DMA enable flag is 
set until the time DMA starts. If any of the DMA-related registers are accessed during this period, 
DMA might not operate correctly. To prevent a DMA problem during this period, run another 
process, such as inserting a dummy Load command. (The main processor executes a Load 
command in "'h cycle^ of the system clock, so you would need to insert two or more^ Load 
commands to the same register.) 

2. When stopping DMA 

DMA begins when the signal that serves as the start trigger is issued. If the CPU disables DMA at 
the same time the start trigger is issued, DMA could lock up. Therefore, be sure to disable DMA at 
least 4 cycles after the start trigger. 

1. When the DMA repeat feature is off 

Because the DMA stops automatically after it is executed once, do not forcibly clear the DMA 
enable flag. Instead, wait for the flag to become 0. 

2. When the DMA repeat feature is on 

Be sure to clear the DMA enable flag with the CPU at least 4 cycles^ after the signal that 
serves as the DMA start trigger. For example, you can safely stop DMA using the interrupt 
generated when DMA ends, clearing the DMA enable flag before the next start trigger is 
issued. 

If you cannot use this method, stop DMA by using the procedure described below. 

3. Stopping DMA in H-Blank or V-Blank auto-start mode 

During a V-Blank period, DMA is stopped, and the start trigger is not issued, so you can safely 
clear the DMA enable flag at that time. If you cannot use this method, follow the procedure below: 

Step 1: Write 16 bits to the DMA control register (see Table 8-2). 


Table 8-2 : Register Configuration (Step 1) 


Setting 

Content 

DMA Enable Flag 

1 (Enable) 


1. When operating at double speed in TWL mode, this will be 1/4 cycle. 

2. When operating at double speed in TWL mode, this will be 4 or more. 

3. When operating at double speed in TWL mode, this will be 8 cycles. 
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Setting 

Content 

DMA Start Timing 

00 (Start Immediately mode) 

DMA Repeat Mode 

0 (Disable Repeat Mode) 

Other Bits 

Do not change 


Step 2: Carry out the process for more than four cycles^. 

Example: (NITRO compatibility mode) 

3 NOP or 1 LDR instruction) + 1 st cycie of STR instruction from Step 3 = 4 cycies 
The actuai writing by the STR instruction occurs in the 2nd cycie. 

Step 3: Write 16 bits to the DMA controi register, then stop the DMA (see Tabie 8-3). 

Table 8-3 : Register Configuration (Step 3) 


Setting 

Content 

DMA Enabie Flag 

0 (Disable) 

DMA Start Timing 

00 (Start Immediately mode) 

DMA Repeat Mode 

0 (Disable Repeat Mode) 

Other Bits 

Do not change 


Note: DMA may run one extra time in Step 1. 

Note: In TWL mode, circuit revisions to the NITRO-compatibie DMA controiier can be enabied or 
disabied using the system configuration. If they are enabled, there is no need to consider the 
precautions shown below (the problems described will not be avoided in NITRO-compatibie 
mode). 

Precautions for starting multiple, parallel DMA channels in the ARM9 System Bus 

When ARM946E-S starts accessing regions that cannot be accessed in a single system cycle (33.514 
MHz), such as main memory, an ARM9-DMA with a lower priority (Auto) starts at the same time. The 
automatic startup of ARM9-DMA with a higher priority occurs immediately afterwards, and the DMA with 
higher priority runs out of control. This condition does not exist on ARM7 because the system bus 
specifications differ. 

Workaround 

Of the DMA Parallel Start Categories shown in Table 8-4, items in Category 3 must not be used together. In 
addition, start DMA from TCM. However, V-Blank start and H-Blank start can be used together. 


1. When operating at double speed in TWL mode, this will be 8 cycles. 
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Table 8-4 : ARM9-DMA Parallel Start Category Chart 


DMA Parallel Start Category Number 

DMA Description 

1 

Start Immediately 

2 

Geometry Command FIFO (Normal) 

3 

Geometry Command FIFO (Auto Start) 

V-Blank Start (can use with H-Blank Start) 

H-Blank Start (can use with V-Blank Start or with multiple Fl-Starts) 
Display Synchronization 

Main Memory Display 

Game Card 


8.2 New DMA 

The new DMA controller added to the TWL has the following features. 

• It is possibie to choose between the traditionai fixed method or the round-robin method for DMA 
arbitration. 

• It is possibie to specify, for each channei, the number of words to transfer each time a singie startup 
request is run, as weii as the totai number of words to transfer. 

• It is possibie to specify, for each channei, the number of words to transfer for singie-biock transfers, as 
weii as the number of intervai cycies between biock transfers. 

• The oniy transfer bit width is 32 bits. 

NDMA Global Control Register 

Name Address Attribute Initial Value 

NDMAGCNT 0x04004100 R/W 0x00000000 


31 24 

23 19 16 

15 8 

7 0 













CPUCYCLE 

















□ 












Cycle Selection 


















• AM[d31] : DMA Arbitration Method 


0 

Fixed Method 

1 

Round-Robin (Revolving) Method 


• CPUCYCLE[d19-d16] : Cycie Seiection 

When round-robin is seiected as the DMA arbitration method, this seiects the number of cycies that 
can be executed when there is a request from the DSP or the ARM9 to the ARM9 bus. It will be 
ignored if there are no requests from the DSP or the ARM9 to the ARM9 bus. 


0000 

0 cycles 

1000 

128 cycles 

0001 

1 cycles 

1001 

256 cycles 

0010 

2 cycles 

1010 

512 cycles 
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0011 

4 cycles 

1011 

1,024 cycles 

0100 

8 cycles 

1100 

2,048 cycles 

0101 

16 cycles 

1101 

4,096 cycles 

0110 

32 cycles 

1110 

8,192 cycles 

0111 

64 cycles 

1111 

16,384 cycles 


NDMAx Source Address Registers (x = 0 - 3) 

Name Address Attribute Initial Value 

NDMAxSAD (x =0 - 3) 0x04004104,0x04004120,0x04004158 R/W 0x00000000 


31 27 24 23 16 15 8 7 0 


DMASRC 



DMA Source Address 




NDMAx Destination Address Registers (x = 0 - 3) 

Name Address Attribute Initial Value 

NDMAxDAD (x =0 - 3) 0x04004108, 0x04004124, 0x04004140, 0x04004150 R/W 0x00000000 


31 24 23 1615 87 20 


DMADEST 



DMA Destination Address 




• DMASRC, DMADEST [d31-d02] : Source (Destination) Address 

Zeroes are aiways output for the iower 2 bits of the DMA source address and the DMA destination 
address of the new DMA. 

NDMAx Totai Words Transferred Count Register (x = 0 - 3) 

Name Address Attribute Initial Value 

NDMAxTCNT (x =0 - 3) 0x040041 OC, 0x04004128, 0x04004144, 0x04004160 R/W 0x00000000 


31 27 24 23 16 15 8 7 0 






TOTALCNT 





Total Number of Words Transferred 


• TOTALCNT[d27-dOO] : Totai Number of Words Transferred 

If the totai number of words transferred is set to 0x00000000, the count wiii be set to 0x10000000. The 
totai number of words transferred can be an integer muitipie of the transferred word count or the word 
count of biock transfers, and does not have to be a vaiue higher than those counts. 
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NDMAx Word Count Register (x = 0 - 3) 

Name Address Attribute Initial Value 

NDMAxWCNT (x =0 - 3) 0x04004110, 0x0400412C, 0x04004148, 0x04004164 R/W 0x00000000 



• WORDCNT[d23-dOO] : Number of Words to Transfer 

If the number of words to transfer is set to 0x000000, the count will be set to 0x1000000. The number 
of words to transfer can be an integer multiple of the number of words for block transfers, and does not 
have to be a value higher than those counts. 

NDMAx Block Transfer Interval Register (x = 0 - 3) 

Name Address Attribute Initial Value 

NDMAxBCNT (x =0 - 3) 0x04004114, 0x04004130, 0x0400414C, 0x04004168 R/W 0x00000000 



• PS[d17-d16] : Prescaler Selection 


00 

System Clock (33.514 MHz) 

01 

1/4th Frequency of the System Clock 

10 

1/16th Frequency of the System Clock 

11 

1/64th Frequency of the System Clock 


• ICNT[d15-d00] : Interval Timer 

If the interval timer is set to 0x0000, the specified number of words to transfer will be transferred 
continuously until finished. 

NDMAx Fill Data Register (x = 0 - 3) 

Name Address Attribute Initial Value 

NDMAxFDATA (x =0 - 3) 0x04004118, 0x04004134, 0x04004150, 0x0400416C R/W 0x00000000 
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NDMAx Control Register (x = 0 - 3) 

Name Address Attribute Initial Value 

NDMAxCNT (x =0 - 3) 0x0400411 C, 0x04004138, 0x04004154, 0x04004170 R/W 0x00000000 



• E[d31] : DMA Enable Flag 


0 

Disable 

1 

Enable 


• I[d30] : Interrupt Enable Flag 


0 

Disable 

1 

Enable 


• CM[d29] : Repeating Mode Selection Fiag 


0 

Not in repeating mode 

1 

Repeating mode 


• IM[d28] : Immediate Mode Seiection Fiag 


0 

Not in immediate mode 

1 

Immediate mode 


• MODE[d27-d24] : DMA Startup Mode Seiection 


0000 

Timer 0 

0001 

Timer 1 

0010 

Timer 2 
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0011 

Timer 3 

0100 

TWL / NITRO Card 

0101 

Setting Prohibited 

0110 

Start up with V-Blank 

0111 

Start up with H-Blank 

(Wili net start up with H-Blank during a V-Blank) 

1000 

Start up synchronized with the display 

(Start up synchrenized with the start ef H-Blank drawing 

during the display Interval) 

1001 

Work RAM 

1010 

Geometry Cemmand FIFO 

1011 

Camera 

1100 

Setting Prohibited 

1101 

Setting Prohibited 

1110 

Setting Prohibited 

1111 

Setting Prohibited 


• WORCNT[d19-d16] : Block Transfer Word Count 


0000 

1 word 

1000 

256 words 

0001 

2 words 

1001 

512 words 

0010 

4 words 

1010 

1,024 words 

0011 

8 words 

1011 

2,048 words 

0100 

16 words 

1100 

4,096 words 

0101 

32 words 

1101 

8,192 words 

0110 

64 words 

1110 

16,384 words 

0111 

128 words 

1111 

32,768 words 


• SRL[d15] : Source Address Reload Flag 


0 

Do not reload 

1 

Reload 


• SAR[d15-d13] : Source Address Update Method Selection 


00 

Increment 

01 

Decrement 

10 

Fixed address 

11 

No address 
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• DRL[d12] : Destination Address Reioad Fiag 


0 

Do not reload 

1 

Reload 


• DAR[d11-d10] : Destination Address Update Method Seiection 


00 

Increment 

01 

Decrement 

10 

Fixed address 

11 

Setting prohibited 


• Differences Between the Arbitration Methods 

There are two methods avaiiabie for DMA arbitration: the fixed method, which has the fixed priorities 
NDMAO > NDMA1 > NDMA2 > NDMA3, and the round-robin method, which rotates the bus ownership 
in the direction of NDMAO to NDMA3. These methods can be set using the Giobai Controi Register 
(NDMAGCNT). 

With the fixed method, if a request arrives whose priority is higher than the currentiy running DMA 
transfer, the current transfer wiii be paused once the specified number of words to transfer have 
compieted their biock transfer, and the higher-priority DMA transfer wiii begin. Converseiy, if a request 
arrives whose priority is iower than the currentiy running DMA transfer, the incoming request wiii be put 
on hoid untii the current DMA transfer is compieted. 

With the round-robin method, the system wiii iook up the requested DMA channeis, and once the 
specified number of words to transfer specified for each channei have compieted their biock transfer, 
bus ownership wiii be transferred to the next entity (in the order NDMAO, NDMA1, NDMA2, NDMA3, 
DSP, and ARM9), inciuding the DMA channei that is running, after which the DMA transfer for the 
channeis and the bus access for the DSP and ARM9 wiii begin. 

In addition, the round-robin method makes it possibie to specify the number of accessibie cycies for 
the DSP or ARM9 bus. This can be specified using the Cycie Seiection bits of the Giobai Controi 
Register. 

• Immediate Mode and Repeating Mode 

Immediate Mode wiii start DMA with immediate mode seiected and Enabie Fiag set to enabied. DMA 
transfers started in Immediate Mode wiii set the Enabie Fiag to disabied once the number of words to 
transfer specified in the Words Transferred Counter Register (NDMAxWCNT) have compieted. When 
started in Immediate Mode, the Repeating Mode Seiection Fiag and the Totai Number of Words 
Transferred setting wiii be ignored. 

Repeating Mode wiii start DMA with repeating mode seiected, set the Enabie Fiag to enabied, and 
then start the DMA request for the hardware seiected in the DMA Startup Mode Seiection bits. DMA 
Transfers started in Repeating Mode wiii repeatediy transfer their number of words to transfer untii the 
Enabie Fiag is set to disabied. When started in Repeating Mode, the TOTALCNT setting is ignored. 

DMA transfers that occur neither in Immediate Mode nor Repeating Mode wiii transfer the number of 
words to transfer untii the totai number of words to transfer is reached. After compietion, the Enabie 
Fiag is set to disabied. 
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• Block Transfers 

With the new DMA, once DMA transfers begin, the bus wiii be monopoiized untii the seiected number 
of words for biock transfers has compieted. A singie biock transfer cycie wiii never be spiit up. 

Once the first biock transfer compietes, the next biock transfer wiii start after the number of cycies 
specified in the intervai timer. The intervai timer is a down counter, so it wiii count down for each 
seiected prescaier, and once it reaches zero, the DMA request for the next biock transfer wiii be 
issued. If the intervai timer is set to 0, the specified number of words to transfer wiii be transferred 
continuousiy untii finished. 

• Reioading Addresses 

If the source address and destination address are set to reioad, after the number of words to transfer 
have been compieteiy transferred, the incremented or decremented address wiii be reset to the 
address used when the transfer was started. 


• The Fiii Data Register 

By seiecting "No address" as the update method for the source address, it is possibie to skip the read 
cycie and oniy write the vaiue set for the Fiii Data Register (NDMAxFDATA) during the write cycie to 
the destination address. Since this occurs oniy during the write cycie, this iets you ciear a region to a 
fixed vaiue faster than is possibie with a standard DMA transfer. 
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9 Timer 

The ARM9 bus side of TWL comes equipped with a 4-channei, 16-bit timer. 

When the timer is enabied, the Count Register counts up according to the presca/er (frequency divider) 
cycie specified with the Controi Register. 

An interrupt can be generated when the Count Register overfiows. 

If the Count Register overfiows, the vaiue set when the count began is ioaded, and the count starts over. 


TM0CNT_L: Timer 0 Count Register 

Name: TMOCNT L Address: 0x04000100 Attribute: R/W Initial Value: 0x0000 


15 8 

7 0 

















Timer 0 Counter 


• [d15-dOO]: Timer 0 Counter 


TM0CNT_H: Timer 0 Controi Register 

Name: TMOCNT H Address: 0x04000102 Attribute: R/W Initial Value: 0x0000 


15 










E 

1 





PS 















Prescaler 


• [d07-d00]: Timer 0 Control 

• E[d07]: Timer 0 Enabie Fiag 


0 

Disable 

1 

Enable 


• I[d06]: Interrupt Request Enable Flag 


0 

Disable 

1 

Enable 


• PS[d01-d00]: Prescaler Selection Flag 


00 

System Clock (33.514 Mhz) 

01 

1/64 of System Clock 

10 

1/256 of System Clock 

11 

1/1024 of System Clock 
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TMxCNT_L: Timer x Count Register (x = 1 - 3) 

Name: TMxCNT_L (x=1-3) Address: 0x04000104,0x04000108,0x04000100 Attribute: R/W Initial Value: 0x0000 


15 8 

7 0 

















Timer x Counter 


• [d15-dOO]: Timer x Counter 


TMxCNT_H: Timer x Controi Register (x = 1 - 3) 

Name: TMxCNT_H (x =1-3) Address: 0x04000106,0x0400010A,0x0400010E Attribute: R/W Initial Value: 0x0000 


15 










E 

1 




CH 

PS 














Multi- 

Staae 

Prescaier 


• [d07-d00]: Timer x Controi 

• E[d07]: Timer x Enabie Fiag 


0 

Disable 

1 

Enable 


• I[d06]: Interrupt Request Enabie Fiag 


0 

Disable 

1 

Enable 


• CH[d02]: Muitistage Counter Seiection Fiag 


0 

According to Prescaier setting 

1 

Counts up when timer (x-1) overfiows 
regardiess of Prescaier setting 


• PS[d01-d00]: Prescaier Seiection Fiag 


00 

System Ciock (33.514Mhz) 

01 

1/64 of System Ciock 

10 

1/256 of System Ciock 

11 

1/1024 of System Ciock 
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10 Interrupts 

This chapter describes the hardware interrupts for the ARM9 main processor. 

When an interrupt request signai occurs from each piece of hardware, the bit that supports the interrupt 
request register is set, and if interrupts are enabied, the CPU is informed of the interrupt occurrence. 

Each hardware interrupt request signai can be disabied individuaiiy via the interrupt enabie register. 

10.1 Interrupt Master Enable Register 

This register can disabie registers as a whoie, and it configures whether to disabie aii registers or to enabie 
the interrupt enabie register settings. 

IME: Interrupt Master Enable Register 

Name: IME Address: 0x04000208 Attribute: R/W Initial Value: 0x0000 


15 

















IME 


















• IME[d00]: Interrupt Master Enable Flag 


0 

Disable all interrupts 

1 

Enabie the Interrupt Enable Register settings 
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10.2 Interrupt Enable Register 

Each hardware interrupt request can be disabled individually. 

Setting each bit enables interrupt requests from the corresponding hardware. Conversely, interrupt 
requests from corresponding hardware are disabled when the bit is reset. 

The pink areas in the register table are the bits that were added with TWL. If the extended features are 
turned off in the system configuration in TWL mode, they will all be fixed at 0. The yellow area in the 
register table is the bit whose specifications has changed on the TWL. 

IE: Interrupt Enable Register 

Name: IE Address: 0x04000210 Attribute: R/W Initial Value: 0x00000000 



• ND3[d31]: New DMA3 Interrupt Permission Flag 

• ND2[d30]: New DMA2 Interrupt Permission Flag 

• ND1[d29]: New DMA1 Interrupt Permission Flag 

• ND0[d28]: New DMAO Interrupt Permission Flag 
For more information, see "8 DMA" on page 297 . 

• CAM[d25]: Camera Interrupt Permission Flag 

• DSP[d24]: DSP Interrupt Permission Flag 

• GF[d21]: Geometry Command FIFO Interrupt Permission Flag 
For more information, see " 7.2.16 Status " on page 245. 

• Ml[d20]: TWL/NITRO Card IREQ MC Interrupt Permission Flag 

• MC[d19]: TWL/NITRO Card Data Transfer Completion Interrupt Permission Flag 

• IFN[d18]: ARM9 - ARM7 FIFO Not Empty Interrupt Permission Flag 

• IFE[d17]: ARM9 - ARM7 FIFO Empty Interrupt Permission Flag 

• A7[d16]: ARM7 Interrupt Permission Flag 

• MD[d14]: TWL/NITRO Card MC_DET Interrupt Permission Flag 

• I/D[d13]: Game Pak IREQ/DREQ Interrupt Permission Flag 

Because the Game Pak functionality has been removed, this interrupt will not occur. 

• K[d12]: Key Interrupt Permission Flag 
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For more information, see " 13.2 Interrupt Flandiina for Kev Input " on page 330. 

• D3[d11]: DMA3 Interrupt Permission Fiag 

• D2[d10]: DMA2 Interrupt Permission Fiag 

• D1[d09]: DMA1 Interrupt Permission Fiag 

• D0[d08]: DMAO Interrupt Permission Fiag 

For more information, see "8 DMA" on page 297 . 

• T3[d06]: Timer 3 Interrupt Permission Fiag 

• T2[d05]: Timer 2 Interrupt Permission Fiag 

• T1[d04]: Timer 1 Interrupt Permission Fiag 

• T0[d03]: Timer 0 Interrupt Permission Fiag 

For more information, see " 9 Timer " on page 309. 

• VE[d02]: V-Counter Match Interrupt Permission Fiag 

• HB[d01]: H-Biank Interrupt Permission Fiag 

• VB[d00]: V-Biank Interrupt Permission Fiag 

For more information, see " 5.3 Dispiav Status " on page 75. 
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10.3 Interrupt Request Register 

When an interrupt request from a hardware component occurs, the corresponding bit for the hardware 
component is set in the interrupt request register. 

Aiso, if 1 is written to the bit where the interrupt request fiag is set, the interrupt request fiag is reset. 

The pink areas in the register tabie are the bits that were added with TWL. If the extended features are 
turned off in the system configuration in TWL mode, they wiii aii be fixed at 0. The yeiiow area in the 
register tabie is the bit whose specifications has changed on the TWL. 

IF: Interrupt Request Register 

Name: IF Address: 0x04000214 Attribute: R/W Initial Value: 0x00000000 



• ND3[d31]: New DMA3 Interrupt Request Flag 

• ND2[d30]: New DMA2 Interrupt Request Flag 

• ND1 [d29]: New DMA1 Interrupt Request Flag 

• ND0[d28]: New DMAO Interrupt Request Flag 
For more information, see "8 DMA" on page 297 . 

• CAM[d25]: Camera Interrupt Request Flag 

• DSP[d24]: DSP Interrupt Request Flag 

• GF[d21]: Geometry Command FIFO Interrupt Request Flag 
For more information, see " 7.2.16 Status " on page 245. 

• Ml[d20]: TWL/NITRO Card IREQ_MC Interrupt Request Flag 

• MC[d19]: TWL/NITRO Card Data Transfer Completion Interrupt Request Flag 

• IFN[d18]: ARM9 - ARM7 FIFO Not Empty Interrupt Request Flag 

• IFE[d17]: ARM9 - ARM7 FIFO Empty Interrupt Request Flag 

• A7[d16]: ARM7 Interrupt Request Flag 

• MD[d14]: TWL/NITRO Card MC_DET Interrupt Request Flag 

• I/D[d13]: Game Pak IREO/DREO Interrupt Request Flag 

Because the Game Pak functionality has been removed, this interrupt will not occur. 

• K[d12]: Key Interrupt Request Flag 
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For more information, see " 13.2 Interrupt Flandiina for Kev Input " on page 330. 

• D3[d11]: DMA3 Interrupt Request Flag 

• D2[d10]: DMA2 Interrupt Request Flag 

• D1[d09]: DMA1 Interrupt Request Flag 

• D0[d08]: DMAO Interrupt Request Flag 

For more information, see "8 DMA" on page 297 . 

• T3[d06]: Timer 3 Interrupt Request Flag 

• T2[d05]: Timer 2 Interrupt Request Flag 

• T1 [d04]: Timer 1 Interrupt Request Flag 

• T0[d03]: Timer 0 Interrupt Request Flag 

For more information, see " 9 Timer " on page 309. 

• VE[d02]: V-Counter Match Interrupt Request Flag 

• HB[d01]: H-Blank Interrupt Request Flag 

• VB[d00]: V-Blank Interrupt Request Flag 

For more information, see " 5.3 Display Status " on page 75. 
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10.4 Interrupt Cautions 

10.4.1 Clearing IME and IE 

Even while the command to clear all flags in the IME and IE registers is executing, reievant interrupts are 
generated. 

When ciearing the IE flags, be sure to clear IME first to avoid inconsistencies in interrupt checks. 

10.4.2 Multiple Interrupts 

If clearing of IME and an interrupt occur at the same time, multiple interrupts are not accepted during that 
interrupt. Therefore, you must set IME after clearing it during the interrupt routine. 

10.4.3 Interrupt Delays During DMA Operation 

The CPU cannot access RAM other than the TCM or cache RAM during DMA operations. 

Therefore, during the interval until the DMA stops, the interrupt is delayed when performing interrupt 
handling on anything other than TCM. 

10.4.4 Interrupts from ARM7 

The A7, IFE, and IFN interrupts are for use by the subprocessor and the subprocessor API for 
communications. 

The subprocessor API will not operate properly if these interrupts are disabled or if the interrupt request is 
reset. 

10.4.5 Interrupts from the DSP 

DSP interrupts are for use by the DSP API for communications with the DSP. 

The DSP API will not operate properly if these interrupts are disabled or if the interrupt request is reset. 

10.4.6 Interrupts from the Camera 

CAM interrupts are for use by the Camera API for communications with the camera. 

The Camera API will not operate properly if these interrupts are disabled or if the interrupt request is reset. 
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11 Power Management 

As with NITRO, the Power Management API of the TWL can be used by the application to put the TWL into 
Sleep mode, to control power to various circuits, to check for the low-battery state, and to check whether 
the system is open or closed. 

11.1 Sleep Mode 

The application can use the Power Management API to put the system into Sleep mode. In Sleep mode, all 
circuits in the TWL Processor stop. Power to the LCD and the sound is turned off, so there is nothing 
displayed and no sounds are played. However, the data in the TWL Processor internal memory and in 
main memory are retained. 

The Power LED blinks slowly in Sleep mode. A fully charged battery lasts about ten days in Sleep mode. 

Table 11-1 shows the factors that cause the system to recover from Sleep mode and the timing with which 
this happens. 


Table 11-1 : Conditions for Recovering from Sleep Mode 


Conditions for Waking 

Timing 

TWL System Is Opened 

When TWL is opened 

RTC Alarm Feature 

When the alarm reaches the set time 

TWL/NITRO Game Card 

When a TWL/NITRO Game Card is accidentally removed 

Key Entry 

When a previously specified key (with the exception of X or Y) 
is pressed 


Note: Because the Game Pak slot has been removed, and interrupts from the Game Paks are constantly 
occurring, it is not possible to transition to Sleep mode when Game Pak interrupts are permitted. 

Note: In Sleep mode, it is difficult to perform shutdown processing in the same way as you would in 

Active mode since the overall system status is different from that of Active mode. For this reason, 
we perform any necessary processing in advance when making the transition to Sleep mode, and 
do not perform any shutdown processing while in Sleep mode. With TWL, the shutdown process 
that was registered using the Power Management API will be called automatically when the 
system transitions to Sleep mode. Consequently, even if the power is cut off suddenly during 
Sleep mode, the system will behave as though the power had been turned off in Active mode. 
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11.2 Controlling Various Power Supplies 

The Power Management API can be used to control the power supply to the sound circuitry, LCD backiight, 
LCD, microphone, system, and graphics. 

11.2.1 Sound 

It is possibie to controi the power suppiy to the sound circuitry. However, that function is not currentiy being 
disciosed. 

11.2.2 LCD Backlight 

The Power Management API can be used to control the power supply to the backlight of the upper screen 
and the backlight of the lower screen separately. When the application is using only one LCD screen, the 
power can be turned off to the screen that is not being used to reduce battery consumption. 

When no game is being played and the system is not standing by for wireless, if you choose not to display 
on either LCD and to turn off power to the LCD backlight in consideration of battery life, we suggest that 
you move to Sleep mode, which more effectively reduces power consumption. 

11.2.3 LCD 

The Power Management API can be used to control power supply to both the upper and lower screen 
LCDs. Furthermore, the LCD backlight can be turned off regardless of the LCD backlight settings. 
However, the LCD backlight settings are preserved. 

When there is no display on the LCD screen, such as when the application is waiting for wireless 
communication, battery consumption can be controlled by turning off the power supply to the LCD. 

When the system is not standing by for wireless, if you choose to turn off power to the LCD in consideration 
of battery life, we suggest that you move to Sleep mode, which more effectively reduces power 
consumption. 

Note: Although the power supply to the LCD can be directly controlled with the graphics power control 
register mentioned below, the LCD circuitry may be damaged according to when the LCD is turned 
on or off. Therefore, directly changing the register value is prohibited. When manipulating the 
power supply to the LCD, always use the API. 

When the LCD is turned off, the power supply for the sound amp is also turned off, and the 
speaker will not function. However, if headphones are connected when the LCD is on, and then 
the LCD is turned off, sound can still be played through the headphones. Also, unlike NITRO, the 
TWL guarantees that sound will be played through the headphones, even if the headphones are 
connected when the LCD is off. 

11.2.4 Microphone 

When using the microphone, power must be provided to the programmable gain amp (PGA). The Power 
Management API can be used to control the provision of power to the PGA. 

Note: Do not use the microphone for 3 seconds after it is turned on. 

11.2.5 System 

The Power Management API can be used to perform a system reset or turn off the TWL’s power 
(shutdown). 

Note: Depending on the unit, there is no guarantee that the system will be reliably shut down if a 

shutdown is executed when the LCD is off (in rare instances the system may restart). Therefore, 
be sure to perform a shutdown only when the LCD is on. 
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11.2.6 Graphics 

Power consumption can be reduced by: controlling the clock supply to the circuits of the geometry engine, 
the rendering engine, and the 2D graphics engine; and disabling circuits that are not being used. 

Figure 11-1 : POWCNT: Graphics Power Controi Register 

Name: POWCNT Address: 0x04000304 Attribute: R/W Initial value: 0x0000 


15 


DSEL 






2DGB 






GE 

RE 

2DGA 

LCDE 


















2D Graphics Engine B 
Enabie Fiag 


Geometry Engine 
Enabie Fiag 


Rendering Engine 
Enabie Fiag 


2D Graphics Engine A 
Enabie Fiag 


Enabie Fiag for both LCDs 


• 2DGB[d09] : 2D Graphics Engine B Enable Flag 

Used to reduce power consumption when the 2D Graphics Engine B is not being used. 


0 

Disable 

1 

Enable 


• GE[d03] : Geometry Engine Enable Flag 

When the geometry engine is enabled, issue the SwapBuffers command once. 


0 

Disable 

1 

Enable 


• RE[d02] : Rendering Engine Enable Flag 

If the rendering engine is enabled, issue the SwapBuffers command once. 


0 

Disable 

1 

Enable 


• 2DGA[d01] : 2D Graphics Engine A Enable Flag 

Used to reduce power consumption when only 3D graphics are being used. 


0 

Disable 

1 

Enable 
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• LCDE[dOO] : Enable Flag for Both LCDs (Use Prohibited) 

When disabied, both the ciock suppiy to the LCD main and sub-controiiers and the power suppiy to the 
main and sub-LCDs are stopped. 


0 

Disable 

1 

Enable 


Note: Use the API to enabie/disabie the LCDs. Be carefui not to change this bit when writing data to 
other bits. 

The memory addresses and registers to which the ciock signai is stopped when each fiag is disabied: 

• When 2D Graphics Engine A is disabied: 

0x04000008 - 0X0400004D 
0x04000050 - 0x04000055 

2D Graphics Engine As 0AM and paiette RAM 

• When 2D Graphics Engine B is disabied: 

0x04001008 - 0x0400104D 
0x04001050 - 0x04001055 

2D Graphics Engine B’s 0AM and paiette RAM 

• When the Geometry Engine is disabied: 

0x04000400 - 0x04000473 
0x04000480 - 0X040004AF 
0x04000400 - 0X040004D3 
0x04000500 - 0x04000507 
0x04000540 - 0x04000543 
0x04000580 - 0x04000583 
0X040005C0 - 0X040005CB 
0x04000600 - 0x04000607 
0x04000610 - 0x04000611 
0x04000620 - 0x04000635 
0x04000640 - 0X040006A3 

• When the Rendering Engine is disabied: 

0x04000320 - 0x04000321 
0x04000330 - 0x04000341 
0x04000350 - 0X0400035D 
0x04000360 - 0X040003BF 
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Table 11-2 shows the behavior that occurs when there is access to memory and registers to which the 
dock signai has been stopped. 

Table 11-2 : Access to Memory and Registers when Clock Signal is Stopped 



Write 

Read 

Memory 

Invalid 

ALL zero 

Registers 

Invalid 

Read-enabled 


11.3 Power Status 

11.3.1 Low Battery State and Battery Level 

When the battery ievei drops beiow 10-20%, the iow battery state is entered, and the power indicator LED 
turns red. When the battery ievei drops to about 1%, the power indicator LED begins a siow, red biinking 
pattern. Appiications have no controi over this behavior. The Power Management API can be used to read 
the battery state data and check directiy whether the system is in the iow-battery state and what the battery 
ievei is in one of 6 ieveis (see Tabie 11 -3). The amount of charge ieft in the battery when the power 
indicator LED is soiid red or in the siow, red biinking pattern is oniy a rough indication due to individuai 
differences in the system, batteries, appiication, and environmentai temperature. 


Table 11-3 : Battery State Data 


Data Type 

Data Content 

Low Battery State 

Low battery state flag (0 - 1) 

Battery Level 

Battery level (0 - 5) 


Details about PMIC status data: 

• Low Battery State Fiag 

0 : Battery stiii has a charge. 

1 : Battery is iow. 

• Battery Levei 

0 : 0% battery ievei (Empty) 

1 : 0-1% battery ievei (Low) 

2 : 1-10% battery ievei 

3 : 10-30% battery ievei 

4 : 30-60% battery ievei 

5 : 60-100% battery ievei 

Caiiback functions can be caiied when the battery ievei changes from 2 to 1, or from 1 to 0. These 

caiibacks can be used to detect drops in the battery ievei without having to poii it. 

Note: Appiications that access NAND Fiash memory or SD Memory Cards wiii shut down automaticaiiy 
when there is a iittie extra remaining battery charge. This is done to protect the fiie management 
regions in NAND Fiash memory and SD Memory Cards. As a resuit, such appiications wiii not be 
abie to compieteiy drain the battery. Appiications that oniy access the Game Card or the backup 
memory on the Game Card wiii not shut down the system automaticaiiy when the battery ievei 
runs iow. Such appiications can be piayed untii the battery is compieteiy drained, as with NITRO, 
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but they are unable to detect when the battery level reaches 0, so the corresponding callback will 
not be called. Furthermore, if the backiight is suddeniy changed to a higher brightness setting 
when the battery ievei is at 2, the power may cut off suddeniy. 

11.3.2 TWL Open/Closed State 

The Power Management API can be used to read the status data shown in Tabie 11 -4 to check whether 
the TWL is open or ciosed. 


Table 11-4 : TWL Opened/Closed State Data 


Data Type 

Data Content 

Device Opened/Closed 
State 

TWL Opened/Closed State Flag (0 - 1) 


Details about the TWL open/closed status data: 

• TWL Opened/Ciosed State Fiag 
0 : TWL is open. 

1 : TWL is ciosed. 
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12 Accelerators 

TWL contains both divider and square root computation acceierators. These are the same as those found 
in NITRO except for the revisions to the divider circuit. 

12.1 Divider 

Shown beiow are the Divider Data setting register for the Divider and the Controi Register that specifies 
the Divider mode and indicates the Divider state. 


Divider Data (Numerator, Denominator, Quotient, Remainder) Registers 


Name 

Address 

Attribute 

Initial Value 

Comment 

DIV_NUMER 

0x04000290 

R/W 

0x00000000_00000000 

Numerator 

DIV_DENOM 

0x04000298 

R/W 

0x00000000_00000000 

Denominator 

DIV_RESULT 

0X040002A0 

R/W 

0x00000000_00000000 

Quotient 

DIVREM RESULT 

0X040002A8 

R/W 

0x00000000 00000000 

Remainder 



Signed integer (sign + 63-bit integer part) 

DIVCNT: Divider Controi Register 

Name: DIVCNT Address: 0x04000280 Attribute: R/W Initial value: 0x0000 


15 


14 


BUSY 

DIVO 













MODE 

Busy 

Division 
bv Zero 













Division Mode 


• BUSY[d15]: Busy Flag 


0 

Divider is ready 

1 

Divider is busy 


• DIV0[d14]: Divide-by-zero error fiag 


0 

There is no divide-by-zero error 

1 

There is a divide-by-zero error 
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• MODE[d01-d00]: Divider Mode 


00 

32-blt(DIV NUMER)/32-blt (DIV DENOM) 

quotient 32-blt (DIV_RESULT), remainder 32-blt {DIVREM_RESULT) 

01 

64-blt(DIV NUMER)/32-blt (DIV DENOM) 

quotient 64-blt (DIV_RESULT), remainder 32-blt (DIVREM_RESULT) 

10 

64-blt(DIV NUMER)/64-blt (DIV DENOM) 

quotient 64-blt (DIV_RESULT), remainder 64-blt (DIVREM_RESULT) 

11 

Setting prohibited 


In TWL mode, it is possibie to enabie or disabie the circuit revisions for the divider using the 
SCFG_EXT register in system configuration. When enabied, there is no need to consider the 
precautions shown beiow (these probiems wiii not be resoived in NITRO-compatibie mode). 

Note: Regardiess of the Divider mode, the Division by Zero Error fiag is enabied oniy when aii 64 bits 
of the denominator (DIV_DENOM) are zero. 

For this reason, set aii of the upper 32 bits of the denominator (DIV_DENOM) to 0 even when 
the Divider mode is 32-bit/32-bit or 64-bit/32-bit. 

If the upper 32 bits of the denominator (DIV_DENOM) are not set to 0, the Division by Zero 
Error fiag wiii not function properiy. 
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12.1.1 Number of Calculation Cycles 

After writing to the Divider Data Registers, the DIVCNT register's busy fiag is set during the cycies shown 
in Tabie 12-1, according to the Divider Mode. When the busy fiag has been cieared, you can find the 
caicuiation resuit by reading the register that stores the resuit. 


Table 12-1 : Calculation Bit Count and Calculation Cycle Count by Divider Mode 


Divider 

Mode 

Calculation Bit Count 

Calculation 
Cycle Count 

00 

32bits(DIV NUMER)/32 bits(DIV DENOM) 

Quotient 32 bits {DIV_RESULT), Remainder 32 bits (DIVREM_RESULT) 

18 cycles 

01 

64 bits (DIV NUMER)/32 bits (DIV DENOM) 

Quotient 64 bits (DIV_RESULT), Remainder 32 bits (DIVREM_RESULT) 

34 cycles 

10 

64 bits (DIV NUMER)/64 bits (DIV DENOM) 

Quotient 64 bits (DIV_RESULT), Remainder 64 bits (DIVREM_RESULT) 

34 cycles 


© 2008-2009 Nintendo 
CONFIDENTIAL 


325 


TWL-06-0017-001-D 
Released: February 16, 2009 




TWL Programming Manual 


12.2 Square-Root Unit 

The control registers that indicate the states of the square root caicuiator data register, caicuiation resuit 
register, caicuiation mode, and the square root caicuiator are shown beiow. 

SQRT_PARAM: SORT Data Register 

Name: SQRT PARAM Address: 0x04000268 Attribute: R/W Initial value: 0x00000000_00000000 



Unsigned integer (64-bit integer part) 


SQRT_RESULT: SORT Calculation Result Register 

Name: SQRT RESULT Address: 0x04000264 Attribute: R/W Initial value: 0x00000000 


31 24 

23 16 

15 8 

7 0 

□ 


□ 

□ 



□ 

□ 



□ 

□ 



□ 

□ 




□ 

□ 



□ 

□ 



□ 

□ 



□ 

SORT Calculation Results Data 


SQRTCNT: SORT Control Register 

Name: SQRTCNT Address: 0x04000260 Attribute: R/W Initial value: 0x0000 


15 


BUSY 















MODE 

Busy 















Mode 


• BUSY[d15]: Busy Flag 


0 

Square root calculator ready 

1 

Square root calculator busy 


• MODE[d00]: SORT Computation Mode 


0 

32-bit input 

1 

64-bit input 
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12.2.1 Number of Calculation Cycles 

The SQRTCNT register's busy flag is set during the cycles shown in Table 12-2, according to the 
Computation Mode after writing to the Data Registers. When the busy flag has been cleared, you can find 
the calculation result by reading the register that stores the result. 

Table 12-2 : Input Bit and Calculation Cycle Count by Computation Mode 


SORT 

Computation 

Mode 

Input Bit Count 

Calculation Cycle 
Count 

0 

32-bit input 

13 cycles 

1 

64-bit input 

13 cycles 
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13 Keys 

TWL has A, B, L, R, +Control Pad, START, SELECT, X, and Y digital keys. 

13.1 Input Keys 

The status of the A, B, L, R, +Control Pad, START, and SELECT keys can be verified by reading the key 
input register (KEYINPUT) and checking the status of each bit. Because the X and Y keys are connected 
to the subprocessor, an API must be used to check the input status of these keys. The appiication can read 
aii key data without regard for subprocessor operations when this API is used. 

KEYINPUT: Key Input Register 

Name: KEYINPUT Address: 0x04000130 Attribute: R Default Value: 0x0000 


15 








L 

R 

DOWN 

UP 

LEFT 

RIGHT 

START 

SEL 

B 

A 







Key Input 


• [d09-d00]: Key Input 


0 

Key is being pressed. 

1 

Key is not being pressed. 


Note: ON-OFF may be repeated multiple times in a short time even if the user presses a key oniy once. 
To prevent a button from being pressed twice (chattering/switch bounce), aiiow an intervai 
between readings of the key data (around 1 frame each). The input status of the X and Y keys 
cannot be read directiy from the register. 
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13.2 Interrupt Handling for Key Input 

Key input from the A, B, L, R, +Control Pad, START, and SELECT keys can generate interrupts. The key 
control register (KEYCNT) can be used to specify the key combinations and conditions for which interrupts 
can be generated. 

KEYCNT: Key Control Register 

Name: KEYCNT Address: 0x04000132 Attribute: R/W Default Value: 0x0000 



• LOGIC[d15]: Logic Specification Flag 


0 

Detects if any of the specified keys was pressed 

1 

Detects if all of the specified keys were pressed 


INTR[d14] : Interrupt Request Enable Flag 

0 

Disable 

1 

Enable 

[d09-d00] : Key Selection 

0 

Key is not specified. 

1 

Key is specified. 


Note: Interrupt handling cannot be specified for X or Y key input. 
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14 Sound 

Like NITRO, TWL contains a sound circuit that enabies the processing of 16 channeis of simuitaneous 
sound generation, two sound capture devices that can write the output from a specific channei or a mixer 
to memory, ieft and right speakers that can output sound, and a headphone output jack. The TWL aiso has 
a feature to mix DSP sounds generated in the DSP and a register voiume feature for a mandatory shutter 
sound to be piayed when a photo is taken with the camera. 

The specifications for the mixer have changed with TWL; whereas NITRO used PWM-format output, TWL 
uses l2S-format output. In addition, whereas output to the speakers and headphones were done with 
PMIC on NITRO, this has been changed to a moduie caiied “CODEC.” 

Whiie there have been changes to severai of the moduies, the TWL’s subprocessor (iike NITRO’s 
subprocessor) carries out the sequence processing and the sound generation processing, so there wiii be 
no heavy burden on the main processor even when sound processing is performed. 

The sound circuit is iiiustrated in Figure 14-1. 

Figure 14-1 : Sound Circuit Outiine Diagram 
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14.1 Hardware Specifications 

The specifications for the inciuded sound circuit hardware are as foiiows. 

14.1.1 Data Format 

SbitPCM, 16bitPCM, IMA-ADPCM, PSG rectanguiar waveforms, and noise can be used as formats for 
waveform data. 

The SbitPCM, 1 SbitPCM, and IMA-ADPCM data formats, as weii as descriptions of PSG rectanguiar 
waveforms and noise are shown beiow. 

14.1.1.1 SbitPCM Data Format 

The SbitPCM data format is shown beiow. 


SbitPCM Data Format 



14.1.1.2 1 SbitPCM Data Format 

The 1 SbitPCM data format is shown beiow. 


1 SbitPCM Data Format 
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14.1.1.3 IMA-ADPCM Data Format 

The header and data parts of the IMA-ADPCM data format are shown below. 


IMA-ADPCM Header Format (First 32 bits) 


31 


24 


23 22 


16 


15 


8 7 


■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

□ 

Table Index Initial Value 

Initial Value 


IMA-ADPCM Data Format (From the 33'^'* bit) 


31 24 

23 16 

15 8 

7 0 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

■ 

Data 7 

Data 6 

Data 5 

Data 4 

Data 3 

Data 2 

Data 1 

Data 0 


Note: When repeatedly playing the ADPCM with the repeat feature, set the repeat pointer to the address 
of the data section, rather than that of the header section. 

Aiso, if the repeat pointer is aitered after starting piayback on ADPCM, normai repeat piay is not 
possibie. 

Be sure to stop piayback before making changes to the repeat pointer. 

14.1.1.4 PSG Rectanguiar Waveforms 

The Programmable Sound Generator (PSG) creates tones by aitering the frequency of the output 
rectanguiar waveform (square waves) and the duty ratio. 

The duty ratios of the PSG rectanguiar waveforms used on TWL can be aitered as shown in Tabie 14-1. 

Tabie 14-1 : Duty Ratio and PSG Rectanguiar Wave Waveforms 


Duty Ratio 

Waveform 

12.5% 





1 1 1 1 

1 1 1 1 

1 1 1 1 

1 1 1 1 

1-1-!-8 





1 

1 

1 

1 

25.0% 





1 1 1 1 

1 1 1 1 

1 1 1 1 

1 1 1 1 

- 1 -s-s-s- 





1 

1 

1 

1 

37.5% 





1 1 1 1 

till 

1 1 1 1 

1 1 1 1 





1 

1 

1 

« 

50.0% 





1—1 1 1 1 

1 1 1 

1 1 1 

1-1-1-1-1 



_ 


1 

1 

1 

-1- 

62.5% 




J 

1 1 1 

-1-1-1-1- 

1 1 1 1 

1 1 1 1 

1 1 1 1 





1 

1 

1 

1 

1 

75.0% 




1 « ■ « ■ > 1 

1 1 1 1 1 

1 1 1 1 1 

1 1 1 1 1 

-1-1-1-1-1- 





• 

1 

1 

1 

_ 


_ 

i 


87.5% 

1 

1 

u 

1 1--1 1 

1 1 1 1 1 

1 1 1 1 1 

1 1 1 1 1 


u 



i 

1 

1 


14.1.1.5 Noise 

Noise has no configurabie items. 

Noise can be used to generate white noise on a channei designated for noise. 
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14.1.2 Channels 

Waveform data can be played simultaneously from 16 channels. However, PSG rectangular waveforms 
can be played on only 6 specific channeis, and noise can be piayed on oniy 2 specific channeis of the 16 
channeis. 

Voiume, pitch, and pan (orientation) can be configured for each channei. 

The piayabie channeis for each format are shown in Tabie 14-2. 


Table 14-2 : Overview of Data Formats and Playable Channels 


Data Format 

Playable Channels 

SbitPCM 

Can be played on all channels from 0 to 15. 

16bitPCM 

ADPCM 

PSG Rectangular 
Waveform 

Can be played on Channels 8 to 13. 

8bltPCM, 16bitPCM, and ADPCM cannot be played 
simultaneously on a channel that Is playing a PSG rectangular 
waveform. 

Noise 

Can be played on Channels 14 to 15. 

8bltPCM, 16bitPCM, and ADPCM cannot be played 
simultaneously on a channel that is playing noise. 


14.1.3 Mixer 

With NITRO, the mixer output used pulse width modulation (PWM), but this has been changed to I2S on 
TWL. I2S is a standard interface that is used to send and receive digitai audio data between devices. On 
the TWL, the CPU and CODEC moduie are connected by an I2S bus, which is used to send and receive 
stereo audio data and microphone input audio data. On the TWL, the data iength is fixed at 16 bits, and 
either 32.73 kHz or 47.61 kHz can be seiected as the sampiing rate. 

14.1.3.1 Mixing with DSP Sounds 

The TWL is capabie of mixing DSP sounds that were generated in the DSP with NITRO sounds that are 
output from the sound circuit in the nine proportions shown in Tabie 14-3. 
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Table 14-3: Mixing Ratios for DSP Sounds 


Configuration 

Pattern 

NITRO Sound 
Ratio 

DSP Sound 
Ratio 

Comment 

0 

8/8 

0/8 

NITRO sound only 

1 

7/8 

1 /8 


2 

6/8 

2/8 


3 

5/8 

3/8 


4 

4/8 

4/8 


5 

3/8 

5/8 


6 

2/8 

6/8 


7 

1 /8 

7/8 


8 

0/8 

8/8 

DSP sound only 


14.1.3.2 Register Volume 

In addition to the standard anaiog sound voiume whose audio voiume can be changed, the TWL aiso has 
a “register voiume” feature that ignores the anaiog sound voiume and piays sound from the program at any 
voiume. This is used, for exampie, to piay a shutter sound when a photo is being taken with the camera. 

14.1.3.3 CODEC 

The function of the “CODEC” moduie connected to the TWL’s CPU is to perform conversion between 
anaiog and digitai signais. In addition to converting l2S-format sound (a digitai signai) output from the 
mixer into anaiog format and outputting it to the speakers or headphones, it aiso converts anaiog input 
from the microphone and Touch Panei into digitai format. 

Two operationai modes have been prepared for CODEC. One is CODEC-DS, which was prepared for the 
sake of NITRO compatibiiity. The other is an improved CODEC-TWL mode. Appiications must choose one 
of these operationai modes. 

The operationai mode for CODEC is set by the IPL based on the information stored within the ROM. After 
the appiication is started, it is not possibie to change the operationai mode. 

The “register voiume” feature described above is oniy supported in CODEC-TWL mode. If it is necessary 
for your appiication to force a shutter sound to be piayed when a photo is taken, be sure to choose 
CODEC-TWL mode. 

The differences between CODEC-DS mode and CODEC-TWL mode are summarized in Tabie 14-4. 
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Table 14-4: Differences Between CODEC-DS Mode and CODEC-TWL Mode 


Category 

Item 

CODEC-DS Mode 

CODEC-TWL Mode 

Microphone 

Sampling- 

Related 

Date Length 
(Amplitude Resolution) 

8 bits or 12 bits 

16 bits 

Sampling Rate 

Variable 

47.61 kHz / 32.73 kHz 
23.81 kHz /16.36 kHz 
15.87 kHz/10.91 kHz 
11.90 kHz/8.18 kHz 

Processing Load on 
Sub-Processor 

Comparatively heavy 
(proportional to the 
sampling rate) 

Comparatively light 

Gain Settings 

26, 32, 38, 44 dB 

0-59.5 dB (0.5 dB 
units) 

Other 

Register Volume 
Feature 

Cannot be used 

Can be used 


14.1.4 Master Volume 

The speaker output can be adjusted in 128 steps (from 0 to 127) via the master voiume. 

14.1.5 Sound Capture 

There are two buiit-in sound capture devices on TWL that aiiow output waveform data to be written to 
memory. 

Output from the ieft mixer or output from channei 0 can be written to memory with sound capture 0. 

Output from the right mixer or output from channei 2 can be written to memory with sound capture 1. 

The sampiing frequency can be set up to 1.04876 MHz. The ampiitude resoiution can aiso be set from 8 
bits to 16 bits. 

14.1.6 Cautions 

Piaying waveform data with a high sampiing rate, or piaying sound whose pitch is higher than the originai 
data because of fast-forwarding, ieads to more frequent DMA transfers. 

If DMA transfers occur frequentiy, they affect the main processor processes as weii as subprocessor 
processes, such as wireiess communications and the microphone. 
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14.2 Sound Block Diagrams 

This section shows the biock diagrams for the TWL sound circuits. 

14.2.1 Overall Sound 

The biock diagram for the overaii sound circuit is shown in Figure 14-2. 

Figure 14-2 : Overall Sound Block Diagram 
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14.2.2 Channels 0-3 and Sound Capture 0-1 

The block diagram for channels 0 to 3 and sound capture 0 and 1 is shown in Figure 14-3. 

Figure 14-3 : Channel 0-3 and Sound Capture 0-1 Block Diagram 



Caution 1 : The switches before and after the pan biocks of channeis 1 and 3 are aiways circuits 

connected to seiectors A and B of the finai-step output seiection. Therefore, when channeis 1 
or 3 are seiected as finai-step outputs, sound wiii be output. Be aware of this when you do not 
want to output any sound. 
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Caution 2: The input signal to the mixer from the pan blocks of channels 1 and 3 is determined by the 
priority shown on Table 14-5. When channels 1 and 3 are set to bypass to the final-step 
output, the added channels are input to the mixer. Even if the output of that mixer is configured 
to be captured, channels 1 and 3 will not be input to the mixer (the switch immediately after the 
pan block will connect to GND, and the mixer input will always be 0 in this case only). As a 
result, there will be no reverb. Be aware that reverb using both the mixer and adder is not 
possible when channels 1 and 3 are set to bypass to the final-step output. If you are 
considering Caution 3 below, it is recommended that you use only the mixer. 


Table 14-5 : Switch Input Priority from Channels 1 and 3 to the Mixer 


Priority 

Mixer Input 

Switch State 

High 

0 Input (Connected to GND) 

Sound Final-Step Output 
Bypass Configuration 


Pan 0 along with Pan 2 

Channel Addition and 

Capture Configuration 

Low 

Pan 1 along with Pan 3 

Normal Configuration 


Caution 3: The TWL has two modes, TWL mode and NITRO-compatible mode. The following bug will 
occur in NITRO-compatible mode because fixes for the issue will not apply in NITRO- 
compatible mode. 

There is a fault in the logic (preliminary to selector 0 and 1) for capturing the channel adder 
output. The following situations can occur: 

• When adding channels 0 and 1 along with channels 2 and 3, if an overflow occurs in either 
of the addition results, sign-inverted data will be output. 

• When adding channels 0 and 1 along with channels 2 and 3, if the signs of channels 0 and 
1 and channels 2 and 3 are each negative, the capture data will be forcibly converted to 
the maximum negative value. 

Noise will be output in the sounds from these results. To deal with these faults, make sure that the addition 
data does not become saturated when using the adder, and that the values for channels 0-1 and channels 
2-3 do not both become negative when not using the adder. 
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14.2.3 Channels4-7 

The block diagram for channels 4 to 7 is shown in Figure 14-4. 

Figure 14-4 : Channel 4-7 Block Diagram 


Subprocessor Bus 
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14.2.4 Channels 8-15 

The block diagram for channels 8 to 15 is shown in Figure 14-5. PSG rectanguiar waveforms can be 
piayed on channeis 8 to 13. Noise can be piayed on channeis 14 and 15. 

Figure 14-5 : Channel 8-15 Block Diagram 


Subprocessor Bus 
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14.2.5 Examples of Using Sound 

Examples of normal sound, a reverb effect using sound capture circuitry, and using the sound circuitry for 
sound effects are shown In the figures below. 

14.2.5.1 Normal Use Example 

Under normal use, the sound waveform data read from main memory Is played on each channel, and then 
Is output to the speaker via the mixer. 

An example of a sound circuit under normal use Is shown In Figure 14-6. Red numbers shown In 
Figure 14-6 Indicate the bit count of data at the time of block Input/output. 

Figure 14-6 : Example of Sound Usage (Normal) 
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14.2.5.2 Reverb Example 

A reverb effect (echo) can be achieved using the sound capture feature. 

Use sound capture to store the output from the mixer in Work RAM. A reverb effect resuits from playing the 
stored sound data on a channel and outputting it to the speakers via the mixer. 

An example of sound circuit usage during reverb is shown in Figure 14-7. Red numbers shown in 
Figure 14-7 indicate the bit count of data at the time of block input/output. 

In the example, Channel 1 is used for the reverb effect. 

Figure 14-7 : Example of Sound Usage (Reverb) 



2. Read Capture Data 


Sound 

DMA 


16 


Channel 0 



Sound Capture 0 



Channel 1 



To R 


(Right Side Omitted) 


© 2008-2009 Nintendo 
CONFIDENTIAL 


343 


TWL-06-0017-001-D 
Released: February 16, 2009 





















































1. Write Capture Data 


TWL Programming Manual 


14.2.5.3 Effect Example 

Data can be modified before outputting the sound by using the sound capture feature. 

Store the capture data in Work RAM; after modifying the data using the subprocessor, output the data from 
a channei. 

A sound effect exampie is shown in Figure 14-8. Red numbers shown in Figure 14-8 indicate the bit count 
of data at the time of biock input/output. 

In the example, Channel 1 is used for the effect. 

Figure 14-8 : Example of Sound Usage (Effect) 
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14.3 NITRO-Composer 

There is no need to be concerned with the subprocessor operations when using the NITRO-Composer. 
The NITRO-Composer allows easy playback of even complicated sounds, such as BGM. 

14.3.1 NITRO-Composer Playback Method 

There are three playback methods: sequence playback, waveform playback, and stream playback. 

14.3.1.1 Sequence Playback 

Sequence playback plays a variety of combined sounds, such as BGM and sound effects. 

A maximum of sixteen sequences can be played simultaneously. 

For example, during playback of a BGM that has one sequence assigned to it, up to fifteen sound effects 
can be played simultaneously. 

A variety of parameters for each sequence, such as tempo and volume, can be individually controlled on 
the application side. 

14.3.1.2 Waveform Playback 

Waveform playback is a method for direct playback of waveform data. 

It can play back waveform data, etc., that has been sampled with a microphone. 

14.3.1.3 Stream Playback 

Stream playback plays back long sequences, such as movie soundtracks. 

Waveform data can be played back while the data stored on the TWL/NITRO card is sequentially loaded. 

14.3.1.4 Latency Within the CODEC Module 

During sound playback, there is a calculation latency of 21 / Fs (seconds) between when data enters the 
CODEC module and when the analog signal is output. 

During microphone sampling, there is a calculation latency of 17/ Fs (seconds) between when data enters 
the CODEC module and when the result is output as data. 

Note: “Fs” indicates the sampling rate (32.73 kHz / 47.61 kHz). 
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15 Wireless Communications 

TWL contains two pieces of hardware for wireiess communications using the 2.4GHz band. One is the 
same hardware buiit into the Nintendo DS and Nintendo DS Lite (NITRO wireiess), and the other is new 
hardware that supports high-speed, high-security communication (TWL wireiess). 

It is oniy possibie to use one of these wireiess moduies at a given time. 

Table 15-1: Wireless Module 



15.1 Hardware Specifications 

The hardware specifications for wireiess communications are shown in Tabie 15-2. 


Table 15-2 : Wireless Communications Hardware Specifications 


Item 

Description 

NITRO Wireless 
(NITRO-Compatible Wireless) 

TWL Wireless 

Band Used 

2.4GHz band 

Same as iegacy 

Communications 

Protocoi 

IEEE 802.11 
(Internet Play) 

Nintendo’s proprietary protocoi 
(Muiti-Card Piay) 

Nintendo’s proprietary protocoi 
(Singie-Card Piay) 

IEEE 802.Ilb/g 
(Internet Play) 

Security 

WEP 40 bit/128 bit compatibie 

WEP 40-bit/128-bit compatible 
WPA-PSK (TKIP/AES) 

WPA2-PSK (TKIP/AES) 

Wireless Channels 

13 channeis 

Depends on the country 

- USA/Taiwan: Channels 1-11 

- Japan, Europe, Australia: 

Channels 1-13 

Communications 

Speed 

1 Mbps or 2 Mbps 

1,2, 5.5, or 11 Mbps 

6,9,12,18, 24, 26, 48, or 54 Mbps 
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Communications 

Range 

10-30 meters 

This can change dramatically, 
depending on the environment and 
orientation of the unit. 

Same as legacy 

MAC Address 

Unique for each TWL and thus can 
be used for identification. 

Same as legacy 

Interfering Devices 

Devices that use the 2.4GHz band 
(cordless phones, microwave 
ovens, the wireless adapter for 
Game Boy Advance, WaveBird, 
other Wi-Fi devices, etc.) 

Same as legacy 


Note: When communications is used, power consumption aiso increases, so the battery wiii be 

consumed more quickiy. Accordingiy, when not using communication, put the unit in the STOP 
state using the wireiess communications API. 

The wireiess adapter for Game Boy Advance cannot be used to communicate with NITRO. 

Other devices may cause interference, making communications difficuit. To avoid this, make the 
communications packet size as smaii as possibie. 

15.2 Wireless Manager 

By caiiing the wireiess manager API, you can control the wireless system without worrying about the 
operation of the subprocessor. 

The unit can use Internet Play (it is also possible to select which wireless module to use), Multi-Card Play, 
and Single-Card Play. 

15.2.1 Internet Play 

In this mode, the unit can connect to the Internet using a wireless LAN (IEEE802.11b/g) access point. 

15.2.2 Multi-Card Play 

This mode allows wireless communication between a maximum of 16 systems. 

Because it uses NITRO’s proprietary communications method, data units can be exchanged in less than 
one frame. 

In Multi-Card Play, the maximum communications data size is 512 bytes. 

15.2.3 Single-Card Play 

This mode allows a child device without a TWL/NITRO card to download a game from a parent device with 
aTWL/NITRO card. 

If the parent device sends data with a header that includes address information, the child device’s system 
ROM stores the data in the region specified by the header. 

This mode uses Nintendo’s proprietary protocol. 

Note: Games that are downloaded using DS Download Play (DS Single-Card Play) will run in NITRO 
mode. 
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16 Touch Panel 

The lower screen includes a resistive-membrane touch panel that allows coordinates to be obtained in dot 
units. Although the touch panel can be operated with a finger, a touch pen with a 1.0 mm tip (see " Figure 
16-1 : Comparison of LCD Dot Size and Touch Pen Size " on page 350) is included with the TWL as 
standard equipment. 

The application can use the touch panel without regard for subprocessor operations when using the touch 
panel API. To overcome the differences in the coordinate position data on the API side, the calibration data 
stored in internal flash memory must be read with the I PL correction program and set with the API before 
using the touch panel. 

The touch panel input data shown in Table 16-1 can be read with this API. The API reads in two ways: 
auto-sampling that reads four times per frame and request sampling that reads in real time in response to 
a request. When a request for a read is generated with request sampling, an interval of at least 4.17 msec 
must be maintained between requests to ensure a correct reading. 


Table 16-1 : Touch Panel Input Data 


Data Type 

Data Description 

Touch Panel Input Data 

X coordinate (8 bit), y coordinate (8 bit) 

Touch Determination Flag (1 bit) 

Data Validity Flag (2 bit) 


The details for input data for the touch panel are shown below. 

• x-coordinate, y-coordinate 

x-coordinate : 0 - 255 (dots) 

y-coordinate : 0-191 (dots) 

• Touch Determination Flag 

0 : The touch panel is not being touched 

I : The touch panel is being touched 

• Data Validity Flag 

00 : Both the x-coordinate and y-coordinate are valid 

01 : The x-coordinate is invalid 

10 : The y-coordinate is invalid 

II : Both the x-coordinate and y-coordinate are invalid 

Note: Structurally, the resistive-membrane touch panel can detect coordinates for only one location at a 
time. Therefore, if multiple locations are touched at the same time, the coordinates for each point 
cannot be detected. When the included stylus is used, the touch panel must be pressed down with 
a force of at least 80 g for the location to be detected. In some cases, the touch pen may not be 
able to depress areas within six dots of the screen edge as a result of built-in error between the 
touch panel and the TWL and limitations due to the shape of the touch pen tip. 
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On some occasions, irregular coordinate data are read immediately after the screen is touched or 
immediately after removing the touch pen from the screen. In these cases (in particular when oper¬ 
ating a button displayed on screen), have the application use coordinates that are read in with the 
same value continually as valid data for processing. Note that the touch determination flag and the 
data validity flag are independent of each other, and that there may be a situation where, even 
though invalid data were stored, the touch panel is being touched. For example, cases may occur 
in which invalid data get stored while drawing a figure with a single stroke. In such cases, rather 
than determining that the user removed the touch pen from the touch panel, make the determina¬ 
tion by reading the touch determination flag. 


Figure 16-1 : Comparison of LCD Dot Size and Touch Pen Size 



16.1 Touch Panel Structure 

The construction of the resistive-membrane touch panel is illustrated in Figure 16-2. 

Normally, the space formed between the upper and the lower films, both of which are coated with a 
transparent conducting membrane (ITO membrane: indium tin oxide), prevents current from being 
conducted. When a finger or stylus presses on the panel, the pressure causes the upper and lower films to 
touch and conduct current. The dot spacers prevent erroneous input and the NITRO from being 
continuously on. 


TWL-06-0017-001-D 
Released: February 16, 2009 


350 


© 2008-2009 Nintendo 
CONFIDENTIAL 



TWL Programming Manual 


Figure 16-2 : Touch Panel Structure 
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17 Microphone 

TWL is equipped with an omnidirectionai condenser microphone that can be used for audio sampiing. In 
addition, the user can use a Nintendo DS Series Headset. Microphone sensitivity can vary by up to a factor 
of two, depending on the consoie. Figure 17-1 shows a schematic diagram of the microphone. 

Figure 17-1 : Microphone Schematic 


Internal Microphone 



Nintendo DS Series Headset 


17.1 Changes from NITRO 

The analog-digital conversion that was done on the Touch Panel 1C on NITRO, as well as the gain 
adjustment for the microphone input that was done on the PMIC, will be performed on the “CODEC” 
module due to a specification change for TWL. 

Microphone input data converted with CODEC (in I2S format) is different from NITRO^ in that the data 
length is fixed at 16 bits and the sampling rate can be changed to one of eight levels with 32.73 kHz / 47.61 
kHz as the standard. Moreover, the gain can be adjusted within the range 10.5 - 70.0 dB in 0.5 dB units. 

17.1.1 Operational Modes for CODEC 

Two operational modes have been prepared for CODEC. One is CODEC-DS mode, which was prepared 
for the sake of NITRO compatibility. The other is the improved CODEC-TWL mode. Applications must 
select one of these operational modes. 

The IPL sets CODEC’s operational mode based on information stored within the ROM. The mode cannot 
be changed after an application has started. 

For more about the differences between CODEC-TWL mode and CODEC-DS mode, refer to " Table 14-4 : 
Differences Between CODEC-DS Mode and CODEC-TWL Mode " on page 336. 

The microphone can be used without regard for subprocessor operations when the microphone API is 
used. 

17.1.2 The Microphone in CODEC-TWL Mode 

You can choose from one of four levels for the microphone sampling rate. The sampling rate will change 
depending on the combination with the sound sampling rate configured for the mixer. 


1. On NITRO, the data length was either 8 bits or 12 bits, the sampling rate was variable, and the 
gain could be adjusted to one of four levels. 
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Table 17-1: Microphone Sampling Rates 


Configuration 

Pattern 

Sound Sampling Rate 

47.61 kHz 

32.73 kHz 

0 

47.61 kHz 

32.73 kHz 

1 

23.81 kHz 

16.36 kHz 

2 

15.87 kHz 

10.91 kHz 

3 

11.90 kHz 

8.18 kHz 


Note: By using the microphone API, it is aiso possibie to use sampiing rates other than those shown in 
the tabie above. 

The microphone gain can be specified in 0.5 dB increments in the range 10.5 - 70.0 dB. 

17.1.3 The Microphone in CODEC-DS Mode 

CODEC-DS mode foiiows the specifications used for the microphone on NITRO. 

The sampiing rates that can be specified range from severai kHz to 32 kHz. However, the sampiing rates 
for normai operation depend on the status of subprocessor use. The recording time depends on the 
memory size and sampiing rate provided by the appiication. 

The 60-Hz noise that is synched to the V-Biank is superimposed on the microphone input. However, this 
frequency is very iow and the noise ievei is sufficientiy iow compared to audio input. Therefore, this wiii not 
cause a probiem as audibie sound. 

Note: Wireiess communication and sound processing aiso use the subprocessor. Therefore, if the 

microphone is used at the same time as these features, specify a sampiing rate that takes into 
account the ioad on the subprocessor. In addition, the same seriai bus is used to read touch panei 
data, access the internai fiash memory, and controi the PMIC. If the microphone is used at the 
same time as these features, ensure that confiicts do not occur. Do not use the microphone for 3 
seconds after the power is turned on. 

17.1.4 Microphone Input Values 

The microphone input inciudes a noise component. As a resuit, Nintendo DS systems detect microphone 
input even when there is no sound. The microphone input vaiues when there is no sound wiii vary from one 
system to another in the ranges indicated by Tabie 17-2 and Tabie 17-3. 

To prevent a faise determination that there is microphone input when there is none, avoid determining that 
there is microphone input within these ranges. Moreover, when the gain is high, the sound of the buttons 
being pressed and the sounds of the casing being rubbed wiii be more noticeabiy present in the 
microphone input. Keep this in mind when setting the threshoid vaiue. 
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Table 17-2: Microphone Input Values When There Is No Sound (For the Sound Circuitry of 
the Nintendo DS and the "CODEC-DS" Mode of the TWL System) 




Noise Component 
(Range where it is prohibited 
to determine that there is 
microphone input) 

Gain 

Amplitude Resolution 

Scale 

dB 



±11 

20 

-^26 


Signed 

±13 

40 

-^32 


±15 

80 

-^38.1 

8 bit 


±20 

160 

-1-44.1 


117-139 

20 

-^26 


Unsigned 

115-141 

40 

-^32 


113-143 

80 

-^38.1 



108-148 

160 

-1-44.1 



±2368 

20 

-^26 


Signed 

±2880 

40 

-^32 


±3392 

80 

-^38.1 

16 bit 


±4672 

160 

-1-44.1 


30400-35136 

20 

-^26 


Unsigned 

29888-35648 

40 

-^32 


29376-36160 

80 

-^38.1 



28096-37440 

160 

-1-44.1 
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Table 17-3: Microphone Input Values When There Is No Sound (For the "CODEC-TWL" 

Mode of the TWL System) 



Noise Component 
(Range where it is prohibited to 
determine that there is 
microphone input) 

Gain 

Amplitude Resolution 

Scale 

dB 



±3 

3-20 

10.5-26.0 



±5 

21-40 

26.5-32.0 



±9 

42-80 

32.5-38.0 


Signed 

±16 

84-160 

38.5-44.0 


±32 

168-320 

44.5-50.5 



±51 

355-640 

51.0-56.0 



±110 

669-1280 

56.5-62.0 

8 bit 


±128 

1334-2560 

62.5-70.0 


125-131 

3-20 

10.5-26.0 



123-133 

21-40 

26.5-32.0 



119-137 

42-80 

32.5-38.0 


Unsigned 

112-144 

84-160 

38.5-44.0 


96-160 

168-320 

44.5-50.5 



77-179 

355-640 

51.0-56.0 



18-238 

669-1280 

56.5-62.0 



0-256 

1334-2560 

62.5-70.0 
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Noise Component 
(Range where it is prohibited to 
determine that there is 
microphone input) 

Gain 

Amplitude Resolution 

Scaie 

dB 



±768 

3-20 

10.5-26.0 



±1280 

21-40 

26.5-32.0 



±2304 

42-80 

32.5-38.0 


Signed 

±4096 

84-160 

38.5-44.0 


±8192 

168-320 

44.5-50.5 



±13056 

355-640 

51.0-56.0 



±28160 

669-1280 

56.5-62.0 

16 bit 


±32768 

1334-2560 

62.5-70.0 


32000-33536 

3-20 

10.5-26.0 



31488-34048 

21-40 

26.5-32.0 



30464-35072 

42-80 

32.5-38.0 


Unsigned 

28672-36864 

84-160 

38.5-44.0 


24576-40960 

168-320 

44.5-50.5 



19712-45824 

355-640 

51.0-56.0 



4608-60928 

669-1280 

56.5-62.0 



0-65535 

1334-2560 

62.5-70.0 


Note: When using the TWL’s microphone API to sampie audio input with an effective ampiitude 

resoiution of 12 bits, the iower four bits are actuaiiy padded with zeros and 16 bits of data is 
obtained. Consequentiy, the 16-bit vaiues in Tabie 17-2 and Tabie 17-3 are appiicabie when using 
12-bit sampiing. 

Note: Do not use the ampiitude ievei as the basis for determining whether microphone input is present 
when gain is set to -1-44.5 dB (168x) in CODEC-TWL mode, since the noise component wiii be 
quite noticeabie in this case. 

Note: TWL-compatibie software that uses CODEC-TWL mode wiii run using the Nintendo DS sound 

circuitry when run on a DS or DS Lite system. As a resuit, be aware that the noise component wiii 
be different when run on a TWL than when run on a DS or DS Lite. 


Not aii systems are guaranteed to pick up the fuii range of microphone input vaiues that can be expressed 
with the number of bits for a given ampiitude resoiution. The individuai variation between systems is shown 
in Tabie 17-4 and Tabie 17-5. In determinining whether microphone input is present, avoid methods that 
reiy on vaiues outside the range of guaranteed input vaiues. 
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Table 17-4: Guaranteed Microphone Input Ranges (For the Sound Circuitry of the Nintendo 
DS and the "CODEC-DS" Mode of the TWL System) 


Amplitude Resolution 

Outside of 
Guaranteed Input 
Range 

Outside of Guaranteed Input 
Range 

Guaranteed 
Microphone Input 
Value Ranges 



LOWER LIMIT 

UPPER LIMIT 


8 bit 

Signed 

-128 to-101 

-Hi 00 to -Hi 27 

-100 to -h99 

Unsigned 

Oto 27 

228 to 255 

28 to 227 

16 bit 

Signed 

-32768 to -25664 

-H25648 to -H32752 

-25663 to -H25647 

Unsigned 

0 to 7104 

58416 to 65520 

7105 to 58415 

Table 17-5; 

; Guaranteed Microphone Input Ranges (For the "CODEC-TWL" Mode of the 

TWL System) 

Amplitude Resolution 

Outside of 
Guaranteed Input 
Range 

Outside of Guaranteed Input 
Range 

Guaranteed 
Microphone Input 
Value Ranges 



LOWER LIMIT 

UPPER LIMIT 


8 bit 

Signed 

-128 to -124 

-Hi 23 to-Hl27 

-123 to -Hi 22 

Unsigned 

0 to 4 

251 to 255 

5 to 250 

16 bit 

Signed 

-32768 to -31744 

-H31743 to -H32752 

-31743 to -H31742 

Unsigned 

Oto 1024 

64512 to 65520 

1025 to 64511 


Note: There may be feedback howl and incorrect playback, depending on the system, if the recording of 
the sound input from the microphone and piayback of that recorded sound are performed at the 
same time. 

Note: If using the TWL’s microphone API to sample audio input with an effective amplitude resolution of 
12 bits, the lower four bits are actually padded with zeros and 16 bits of data is obtained. 
Consequently, the 16-bit values in Table 17-4 and Table 17-5 are applicable when using 12-bit 
sampling. 
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18 Real-Time Clock (RTC) 

The TWL has an internal Real-Time Clock (RTC). Time is kept by means of an auto-calendar feature that 
extends through 2099 and accounts for leap years. The maximum error for the clock is ±4 seconds/day. 

The time is set on the following occasions: 

1. When the power is turned on for the first time after the unit is purchased. 

2. When the power is turned on after changing the battery. 

3. When the unit is restarted after the batteries have been drained (unit has been sitting for several 

months with no charge in the batteries). 

4. When the date and time are set from the boot menu. 

When the RTC API is used, the RTC can be used without regard for subprocessor operations. The 

real-time data shown in Table 18-1 can be read with this API. 


Table 18-1 : Real-Time Data 


Data Type 

Data Description 

Real-Time Data 

Year (00 - 99), month (01 -12), date (01 - 31), day (00 - 06), 
hours (00 - 23), minutes (00 - 59), seconds (00 - 59) 

Each value is stored as a binary coded decimal (BCD) value. 


In addition, two types of alarm functions are provided. By setting the alarm from the application and 
engaging sleep mode, the unit can be awakened from sleep mode at a specified time. For information on 
sleep mode, see "11 Power Management" on page 317 . The API can be used to read and write the 
following settings for Alarm 1 and Alarm 2. 


Table 18-2 : Settings for Alarm 1 and Alarm 2 


Data Type 

Data Description 


Year (00 - 99), month (01 -12), date (01 - 31), day (00 - 06), hour (00 - 23), 
minutes (00 - 59) 

Alarm 1 

Separate settings for alarm 1 and 2 can be specified. 

and 

Each value is stored as a binary coded decimal (BCD) value. 

Alarm 2 

Day, hour, and time can be enabled or disabled. 


Example: The alarm can be set to activate at the same time every day by disabling 
the day setting. 


Note: Real-time data cannot be written from the application to the RTC. 
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19 Internal Flash Memory 

The TWL has internal flash memory to store touch panel calibration data, profiie, the TWL initiai settings 
data, and RTC operation information data. The internai fiash memory is dedicated memory for the storage 
of TWL settings data; the appiication cannot write to the internai fiash memory. 

19.1 Touch Panel Calibration Data 

This caiibration data is used to compensate for the variation in coordinate positioning data between 
individuai touch paneis. If an appiication uses the touch panei, the touch panei must be set by reading the 
caiibration data with the API. 

19.2 Profile Data 

The profile data stores information about the owner of the TWL. The profile data in Table 19-1 can be read 
using the API. 


Table 19-1 : Profile Data 


Data Type 

Data Contents 

Owner Information Data 

User ID (22 bytes). User color (1 byte). Birthday 
(2 bytes). Comment (46 bytes) 


The details of the profile data are shown below. 

• User ID (Nickname) 

Nickname string : Maximum of 10 Unicode (UTF-16) characters (20 bytes). No termination code. 

String length : Nickname string length (2 bytes). 

• User Color (Favorite color) 

0-15 : Selected from a set of 16 colors determined by IPL. (RGB values are enclosed by parentheses.) 


0:GRAY 

(12,16,19) 

1: BROWN 

(23, 9, 0) 

2: RED 

(31,0, 3) 

3: PINK 

(31,17,31) 

4: ORANGE 

(31,18, 0) 

5: YELLOW 

(30,28, 0) 

6: LIME GREEN 

(21,31,0) 

7: GREEN 

(0,31,0) 

8: DARK GREEN 

( 0,20, 7) 

9: SEA GREEN 

(9,27,17) 

10: TURQUOISE 

( 6,23,30) 

11: BLUE 

( 0,11,30) 

12: DARK BLUE 

(0, 0,18) 

13: PURPLE 

(17, 0,26) 

14: VIOLET 

(26, 0,29) 

15: MAGENTA 

(31,0,18) 


• Birthday (month and day) (Each is stored as a binary-coded decimal number.) 

Month (1 byte) : Month of birth (01-12) 

Day (1 byte) : Day of birth (01 -31) 

• Comment 

A comment of two lines of a maximum of 23 characters each (23 bytes x 2 = 46 bytes) using Unicode 
(UTF-16). 
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19.3 TWL Initial Settings Data 

The TWL initial settings data stores the ianguage setting. 

Using the API, the TWL initiai settings data in Tabie 19-2 can be read. 


Table 19-2 : TWL Initial Settings Data 


Data Type 

Data Content 

TWL Initial Settings Data 

Language setting (4 bytes) 


The detaiis of the TWL initiai settings data are shown beiow: 

• Language setting 
0:Japanese 
1 : Engiish 
2: French 

3 : German 

4 : Itaiian 

5 : Spanish 

19.4 RTC Operation Information Data 

When setting the reai-time ciock (RTC), the difference in seconds with the initiai data is set. This 
information can be used to determine if the user has changed the RTC data. 

Using the API, the RTC operation information data in Tabie 19-3 can be read. 


Table 19-3 : RTC Operation Information Data 


Data Type 

Data Content 

RTC Operation Information Data 

RTC offset vaiue. 

This vaiue changes each time the RTC setting is 
changed. 
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20 AES Engine 

The TWL system includes an AES (Rijndael) encryption and decryption engine. 

AES (Advanced Encryption Standard) is a symmetric-key (shared-key) type block cipher that has been 
adopted as an encryption standard in the United States. For details about AES, refer to Federal Information 
Processing Standards Publication 197. 

Following is an overview of the built-in AES engine. 

• Encryption Mode: CTR (counter) mode / CCM (counter with CBC-MAC) mode 

(Both modes support both encryption and decryption.) 

• Key Length: 128 bits 

• Block Size: 128 bits 

Figure 20-1 : The AES Engine 


AES Engine 


Input FIFO (64 Bytes) 

CTR/CCM Mode Computation Unit 
Mode Setting 


Initial Value 


Data Length 


MAC Value 



Output FIFO (64 Bytes) 


All AES operations should be done via the API. 

20.1 CTR Mode 

CTR mode is a type of block cipher algorithm (see Figure 20-2). For details, see section 6.5 of NIST 
SP800-38A. One of the limitations of this AES engine is that the input and output data must be in 16-byte 
units. 
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Figure 20-2 : CTR Mode 
CTR Mode 

(Common for Encryption and Decryption) 



20.2 CCM Mode 

COM mode is a type of block cipher algorithm that combines CTR mode with CBC-MAC, which uses the 
final output data from CBM mode as the MAC value (see Figure 20-3). For details, see NIST SP800-38C. 
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Figure 20-3 : CCM Mode 



CCM Mode (Encryption) ^CM Mode (Decryption) 
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It is also possible to enter data (“associated data”) that is not encrypted but is used for the CBC-MAC 
calculation separately from the data to be encrypted or decrypted (the “payload”). When doing so, the 
associated data is entered before the payload. 

In CCM mode, the AES engine also generates the first block (BO) internally in advance of the associated 
data and payload. The method for generating the first block (BO) was implemented as the case where q=3 
(fixed) described in Appendix A of NIST SP800-38C. 

Due to these specifications, the size that can be specified as Nonce is 96 bits. 

Also, the engine doesn’t perform any special processing such as adding the size information. If such 
information is required, enter the pre-formatted information as associated data. 

A limitation of this AES engine is that the input and output data, associated data, and payload must be in 
16-byte units. 

One of the features of this AES engine is that it is possible to suppress output of associated data. 

20.3 Precautions 

In most AES libraries, the key data, MAC data, and input/output data are calculated as big-endian data. In 
contrast, this AES engine treats all data as 128-bit or 96-bit little-endian data, so be aware of this issue. 
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21 Camera 

The TWL system includes two cameras. Although the cameras can be controlled independently, it is not 
possibie to obtain images from both cameras simuitaneousiy. Camera operations shouid aii be done via 
the API. 

The basic specs of the camera are shown beiow. 

• Aperture: f/2.8 (Fixed) 

• Angie of view (when photographing at maximum resoiution) 

Diagonai; 66 degrees 

Horizontai: Approximateiy 54 degrees 
Verticai: Approximateiy 42 degrees 

• Depth of fieid: 20cm - Infinity (deep focus; camera does not contain a macro switch) 

• Maximum resoiution: VGA 

• Maximum frame rate: 30 fps 

• Output format: YCrCb (a YUV>RGB conversion circuit aiso makes it possibie to output in RGB555) 

• Resoiution settings (supports fast configuration changes) 

• Frame rate settings 

• Effect processing (supports fast configuration changes) 

• Fiipping (supports fast configuration changes) 

• Photo mode settings 

• White baiance settings 

• Exposure settings 

• Sharpness settings 


Of these specifications, two settings can be maintained for each camera for the resoiution, effect 
processing, and flipping operations. Switching between the two settings can update the settings faster than 
setting them individuaiiy. 
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21.1 Camera Settings 


The various camera settings that can be configured, such as the resoiution and framerate, are shown 
beiow. 


• Resoiution settings 


• VGA 

• QVGA 

• QQVGA 

• GIF 

• QCIF 

• DS screen zize 

• Doubied height and width of DS screen size 


(640 pixeis wide, 480 pixeis high) 
(320 pixeis wide, 240 pixeis high) 
(160 pixeis wide, 120 pixeis high) 
(352 pixeis wide, 288 pixeis high) 
(176 pixeis wide, 144 pixeis high) 
(256 pixeis wide, 192 pixeis high) 
(512 pixeis wide, 384 pixeis high) 


• Frame rate settings 

• 15 fps, fixed 

• 15-5 fps, variabie 

• 15-2 fps, variabie 

• 8.5 fps, fixed 

• 5 fps, fixed 

• 20 fps, fixed 

• 20-5 fps, variabie 

• 30-5 fps, variabie 

• 30 fps, fixed 

• Effect processing 

• Monochrome 

• Sepia tone (yeiiow) 

• Sepia tone (red) 

• Inversion 

• Inversion (fiim tone) 


- Converts the image to biack and white. 

- Gives the image a sepia tone. Appiies an overaii yeiiow ochre coior 
and gives images a nostaigic feei. 

- Gives the image a sepia tone. Appiies an overaii auburn coior and 
gives images a nostaigic feei. 

- Inverts tone and color, and applies a bluish-violet tone. 

- Inverts tone and color, and applies a magenta tone. The U and V com¬ 
ponents in the inverted image’s YUV data are in reverse order. 


• Flipping 

• Fip vertical 

• Flip horizontal 

• 180 ° rotation 


• Photo mode settings 

• Text capture (QR codes, letters) 

Increases the sharpness and contrast in order to emphasize text outlines. This can capture 
relatively detailed text such as business cards, newspapers, and examination sheets in a way that 
makes recognition easier than normal. QR codes can also be used to some degree. 

• Portrait 

Reduces the contrast and lowers the emphasis on outlines relative to the standard setting. 

• Landscape 

Reduces the exposure (AE) levels below the standard setting and keeps the white balance fixed to 
the Daylight setting, under the assumption that photos will be taken outdoors in this mode. 
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• Night View 

Increases the gain so that images can be captured at a high frame rate, even in iow iight 
conditions. The noise component of the images wiii be increased proportionateiy. Siightiy reduces 
the sharpness reiative to the standard setting. Uses the standard automatic mode for white 
baiance. Taking pictures in this mode under weii iit conditions wiii cause the amount of image 
noise to increase. 

• Night Snap 

This mode has not been prepared as a unique mode, but by combining Landscape mode with the 

variabie 15-2 fps frame rate setting, the camera can be made to take pictures in a “night scenery” 
mode. The camera wiii not operate correctiy if the white baiance is set to “auto” under iow iight 
conditions, so this mode keeps the white baiance fixed to the Dayiight setting. Aiso, because iower 
frame rates wiii have iess image noise, this mode uses the variabie 15-2 fps frame rate setting in 
order to keep the frame rate iow under iow-iight conditions. The sharpness in this mode is siightiy 
higher than the standard setting. 

• White baiance settings 

• Standard (Automaticaiiy adjusted) 

• Tungsten (3200K) 

• White Fiuorescent Light (4150K) 

• Dayiight (5200K) 

• Cioudy/Horizon (6000K) 

• Shade (7000K) 

Note: The automatic white baiance (AWB) can be temporariiy disabied as weii. 

• Exposure settings 

Can be configured from -5 to -i-5. 

Note: The automatic exposure (AE) can be temporariiy disabied as weii. 

• Sharpness settings 

Can be configured from -3 to -i-5. 

• RGB conversion 

Image data from the camera can be obtained in either YCfCt, (YUV422) format or RGB (RGB555) 
format. 

The formuias for converting YUV422 to RGB888 are shown beiow: 

R = 1.000 xY -1-1.402 X (V-128) 

G = 1.000 xY - 0.344 x(U-128) - 0.714 x (V - 128) 

B = 1.000 xY -I-1.772 X (U - 128) 

The resuits of the caicuiation wiii be rounded off if they exceed 255. Then they wiii be scaied to the 
range [0-31], after which they wiii be in RGB555 format. 

The formuias for the reverse conversion (i.e., converting RGB555 to YUV422) are shown beiow: 

Y = 0.299 xR -I-0.587 xG -i-0.114 xB 

U = - 0.169 xR - 0.331 xG -i-0.500 x B -1-128 

V = 0.500 xR - 0.419 xG - 0.081 x B -1-128 
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21.2 Trimming 

It is possible to trim (crop) a portion of a captured image. 

21.3 DMA Transfer 

The new DMA that was added with the TWL is always used in order to transfer images captured by the 
camera to main memory. During DMA transfers, the transfer size for a single transfer must be set to 2 KB 
or less (1024 pixels, since 1 pixel = 2 bytes). 

21.4 Recovery from Sieep Mode 

When transitioning to Sleep mode, the cameras will automatically go into standby. If you want to enable the 
cameras after recovering from Sleep mode, you must handle this on the application side. 
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22 DSP 

TWL includes an XpertTeak™ core made by CEVA, Inc. (the ™ notation will be omitted throughout the 
remainder of this document) as well as a DSP (Digital Signal Processor) block with added local memory, 
which can be shared by the main processors and subprocessors as work RAM. 

22.1 CEVA-Teak Core 

The CEVA-Teak core has dual MAC (Multiply and Accumulation), a word size of 16 bits, and a DSP core 
with 16-bit instructions. It has the following characteristics: 

• Four 40-bit accumulators 

• Two 16x16-bit -> 32-bit multipliers 

• Multiplication and addition can be run in parallel in a single cycle 

• Zero-overhead loops 

It is also equipped with peripheral circuitry such as an 8-channel DMA and an interrupt controller. Several 
communication interfaces have been prepared between the core and the main processor. 

22.2 DSP Memory 

The 16 X 32 KB memory planes built into the DSP core can be used both as local memory for the DSP core 
and as work RAM for the main processor and subprocessor. 

By configuring the registers, it is possible to specify which systems can access each memory plane (it is 
not possible to have multiple cores access the same memory plane simultaneously), and the contents of 
the memory will be retained even if the master (a system that can access the memory plane) is switched. 

Memory mapping and switching the master are done using the System Control register. For details, see 
" Work RAM " on page 40. 

22.3 Communication with the Main Processor 

The DSP core can be controlled from the main processor using the interface register. This interface has 
the following features. 

• Resetting the DSP 

• Reading data from and writing data to the DSP's internal memory space (DSP memory transfer) 

• Sending and receiving small amounts of data using the command / reply register 

• Using the semaphore register to handle exclusion control between the ARM9 and DSP and generate 
interrupts 

22.3.1 Reset 

The DSP can be reset from the main processor by manipulating the DSP's configuration register 
(DSP_PCFG). This reset operation will initialize the DSP core and its peripheral circuitry, but the interface 
register itself will not be reset. 

The configuration register also makes it possible to select the memory space to be accessed during a DSP 
memory transfer, provide interrupt notifications using the status of the read and write FIFOs, and configure 
the data length for read operations. 
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DSP Configuration Register 


Name 


Address 

Attribute Initial Value 

DSP PCFG 

0x04004308 


R/W 0x0000 


15 12 

11 10 9 8 

7 6 5 4 

3 2 10 

MEMSEL 

PRIE2 

PRIE1 

PRIEO 

WFEIE 

WFFIE 

RFNEIE 

RFFIE 

RS 

DRS 

AIM 

DSPR 


• MEMSEL[d15-d12] : Memory Select 

Selects the memory to access during a read from or write to the DSP's internai memory space (DSP 
memory transfer). 



Effect of Setting 

0000 

Data memory 

0001 

Peripheral (MMIO) register 

0101 

Program memory (only write access) 


• PRIE0-2[d09],[d10],[d11] : Repiy Register Write Notification Fiag 

When set to 1, the main processor wiii be notified of an interrupt when the DSP core writes data to the 
corresponding repiy register (DSP_REPx). 

• WFEIE[d08] : Write FIFO Empty Notification Fiag 

When set to 1, the main processor wiii be notified of an interrupt when the write FIFO becomes empty. 

• WFFIE[d07] : Write FIFO Full Notification Flag 

When set to 1, the main processor will be notified of an interrupt when the write FIFO becomes full. 

• RFNEIE[d06] : Read FIFO Not Empty Notification Flag 

When set to 1, the main processor will be notified of an interrupt when the read FIFO is no longer 
empty. 

• RFFIE[d05] : Read FIFO Full Notification Flag 

When set to 1, the main processor will be notified of an interrupt when the read FIFO becomes full. 

• RS[d04] : DSP Memory Read Start Flag 

When a 1 is written, read access to the DSP memory space will begin (the read FIFO will be cleared at 
this time). 

When a 0 is written, read access that is under way is cut off. 

• DRS[d03-d02]: DSP Memory Read Data Length 
Specifies the length of data to read during read access. 
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Effect of Setting 

00 

Single access (1 word) 

01 

8-word burst read 

10 

16-word burst read 

11 

Free-running (read access will continue until It Is cut off) 


• AIM[d01] : Address Auto-Increment Mode 

When set to 1, the transfer address will automatically be incremented after each DSP memory transfer. 

• DSPR[dOO] : DSP Reset 

When set to 1, the DSP core and its peripherai circuitry wiii be reset.Once it has been set to 1, do not 
write a 0 for at ieast 8 cycies of the DSP ciock. 

22.3.2 Status Register 

The status register (DSP_PSTS) iets you know various statuses during communication between the DSP 
and the main processor. 

If you have configured the system so that the main processor wiii not be notified of interrupts from the DSP 
during DSP memory transfers, you can iook the bits in this register (WFEI, WFFI, RFNEI, and RFFI) to find 
out the status of the read and write FIFOs. 

DSP Status Register 


Name 


Address 

Attribute Initial Value 

DSP PSTS 

0x04004300 


R 0x0000 


15 12 

11 10 9 8 

7 6 5 4 

3 2 10 

RCMD 

IM2 

RCMD 

IM1 

RCMD 

IMO 

PRI2 

PRI1 

PRIO 

PSEMI 

WFEI 

WFFI 

RFNEI 

RFFI 

■ 

■ 

PRST 

WTIP 

RTIP 


• RCMDIM0-2[d13],[d14],[d15] : Command Register Read Fiag 

Indicates whether the DSP has read a vaiue written to the DSP command register (DSP_CMDx) by the 
main processor. 



Meaning 

0 

The DSP has read the command register 

1 

The DSP has not read the command register 


• PRI0-2[d10],[d11],[d12] : Repiy Register Update Fiag 

Indicates whether the DSP has updated the DSP repiy register (DSP_REPx). 
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Meaning 

0 

The DSP has updated the reply register 

1 

The DSP has not updated the reply register 


• PSEMI[d09] : Semaphore Register Interrupt Request Flag 

When 1, indicates that there is an interrupt request from the DSP through the semaphore register 
(DSP_SEM) from the DSP (a 1 was written to an unmasked bit in the DSP semaphore register 
DSP_PMASK). 

• WFEI[d08] : Write FIFO Empty Flag 

When 1, indicates that the write FIFO is empty. 

• WFFI[d07] : Write FIFO Full Flag 

When 1, indicates that the write FIFO is full. 

• RFNEI[d06] : Read FIFO Not Empty Flag 

When 1, indicates that the read FIFO is not empty.At least one read can be performed from the DSP 
transfer data register (DSP_PDATA). 

• RFFI[d05] : Read FIFO Full Flag 

When 1, indicates that the read FIFO is full. 

• PRST[d02] : Peripheral Reset Flag 

When 1, indicates that the peripheral (circuitry) is in the process of being reset. After a reset is issued 
to the DSP, once you can verify that this bit has become 0, the peripheral circuitry can be accessed 
while the DSP core is still in the reset state. 

• WTIP[d01] : Write Transfer Underway Flag 

When 1, indicates that a write transfer to the DSP memory is under way. 

• RTIP[d08] : Read Transfer Underway Flag 

When 1, indicates that a read transfer from the DSP memory is under way. 

22.3.3 DSP Memory Transfers 

Using DSP memory transfers, it is possible to access the memory space within the DSP. The memory 
spaces that can be accessed are shown below. 

• All data memory 

• Program memory (write only) 

• Peripheral (circuitry) registers within the DSP (except for some parts) 

On TWL, switching memory banks is the faster way of accessing the data memory and the program 
memory, but for DSP memory transfers, the memory being referenced by the DSP can be accessed 
simultaneously when the DSP is running. 

Two 16-stage FIFOs have been prepared to make memory access more efficient during DSP memory 
transfers. One is used for reads, and the other for writes. The DSP configuration register (DSP_PCFG) can 
be used to notify the main processor of interrupts based on the FIFO status. Furthermore, the DSP status 
register (DSP_PSTS) can be used to determine the FIFO states. 

The following two registers are used during DSP memory transfers. 
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DSP Transfer Data Register 


Name 


Address 

Attribute Initial Value 

DSP PDATA 

0x04004300 


R/W 0x0000 


15 8 7 0 

PDATA 


When the main processor reads this register, a vaiue is popped from the read FIFO, and that vaiue is 
returned. 

When a vaiue is written to this register during a write transfer, the vaiue is pushed onto the write FIFO, and 
the DMA transfer will begin. 

DSP Transfer Address Register 


Name 


Address 

Attribute Initial Value 

DSP PADR 

0x04004304 


W 0x0000 


15 8 7 0 

PADR 


Specifies the address of the DSP memory space to access. This register is used to specify the lower 16 
bits. In order to specify the upper 16 bits, you must set a value in the DMA register within the DSP. 

It is not possible to read values that have been written to this register. Reads will always return 0x0000. 

22.3.4 Command / Reply Register 

The system includes three sets each of 16-bit registers: three command registers (DSP_CMDx) for 
communication from the main processor to the DSP, and three reply registers (DSP_REPx) for 
communication from the DSP to the main processor. 

The DSP core will be notified of writes to the command register by means of interrupts. It is possible to 
determine whether the DSP has read the command register by looking at the status bits (RCMDIMO-2) in 
the DSP status register (DSP_PSTS). 

Depending on the settings in the DSP configuration register (DSP_PCFG), the main processor can be 
notified through an interrupt when the DSP writes to the reply register. The write can also be detected by 
polling the DSP status register without notification. 

DSP Command Register 0-2 (ARM9 > DSP) 


Name 


Address 


Attribute Initial Value 


DSP_CMDx 
(X = 0, 1,2) 


0x04004320,0x04004328,0x04004330 


R/W 0x0000 


15 8 7 0 

APBP_CMDx 
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Writes data from the main processor to be passed to the DSP. 

It is possibie to find out whether the DSP has read this register by iooking up the corresponding bit in the 
DSP status register (RCMDIMx). 

DSP Reply Register 0-2 (DSP > ARMO) 


Name 


Address 


Attribute Initial Value 


DSP_REPx 
(X = 0, 1,2) 


0x04004324, 0x0400432C,0x04004334 


R 0x0000 


15 8 7 0 

APBP REPx 


Reads data that is passed from the DSP to the main processor. 

When the DSP updates this register, 1 wiii be set in the corresponding bit (PRIx) in the DSP status register. 
Aiso, if the corresponding bit (RRlEx) in the DSP configuration register is set to 1, the main processor is 
notified by an interrupt. 

This update oniy supports writes to this register by the DSP, so even if the vaiue is unchanged (that is, if 
the register is overwritten by the same vaiue), it wiii be considered to have been updated. 

22.3.5 Semaphore Register 

The system inciudes a 16-bit (1 bitx 16) semaphore register, which uses interrupts, for mutuai 
communication between the main processor and the DSP. 

DSP Semaphore Register (ARM9 > DSP) 

Name Address Attribute Initial Value 

DSP PSEM 0x04004310 Sw 0x0000 


15 8 7 0 

PSEM 


Writing a 1 for a given bit wiii notify the DSP of an interrupt as iong as that bit is not masked in the DSP's 
semaphore mask register (APBP MASK). 

DSP Semaphore Mask Register (DSP > ARM9) 

Name Address Attribute Initiai Value 

DSP PMASK 0x04004314 R/W 0x0000 


15 8 7 0 

PMASK 


If a given bit is set to 1, the main processor wiii not be notified of an interrupt, even if a 1 is written to the 
corresponding bit of the DSP's semaphore register (APBP_PSEM). 
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DSP Semaphore Clear Register (DSP > ARMS) 


Name 


Address 


Attribute Initial Value 


DSP PCLEAR 0x04004318 


W 0x0000 


15 8 7 0 

PCLEAR 

If 1 is written for a bit, the corresponding bit in the semaphore register (DSP_PSEM) wiii be cieared to 0. 
The content that was written wiii not be retained, so it is not necessary to write 0 after the bit is cieared. 

DSP Semaphore Data Register (DSP > ARMS) 

Name Address Attribute Initial Value 

DSP SEM 0x04004310 R 0x0000 


15 8 7 0 

APBP_PSEM 


It is possibie to read the contents of the DSP's semaphore register (APBP_PSEM). Uniess aii the bits in 

the semaphore mask register (DSP_PMASK) that correspond to the 1 bits written by the DSP core are aii 

set to 1, the main processor wiii be notified of an interrupt. 

22.4 Procedures for Starting the DSP 

To start up the DSP biock, foiiow the procedure beiow. 

1. Preparing the program and data 

Write the program for the DSP to the WRAM-B bank in the work RAM, write the data for the DSP to 

WRAM-C, and assign each memory biock to the DSP. 

2. Preparing to start by configuring the DSP's ciock and reset configuration 

i. Ensure that the DSP_RSTB bit in the system configuration’s SCFG_RST register is 0. 

ii. Suppiy a ciock to the DSP biock by setting the DSP_HCLK bit in the system configuration's 
SCFG_CLK register to 1. 

iii. After suppiying the ciock, wait 8 cycies on the DSP ciock (134 MHz), then set the DSP_RSTB bit 
of the SCFG_RST register to 1 to cancei the reset on the DSP biock. 

iv. At this point, the DSP core wiii start, but the hardware iogic wiii put it into the sieep state. 

3. Boot Process 

i. Write a 1 to the DSPR bit in the DSP configuration register (DSP_PCFG). 

ii. Wait for the PRST bit in the DSP status register (DSP_PSTS) to become 0. (During this time, you 
can switch between the WRAM-B and WRAM-C banks and change their contents.) 

iii. Write a 0 to the DSPR bit in the DSP configuration register. 

iv. Execution of the program wiii begin starting with address 0 in the memory for DSP programs (the 
first address in the memory biock for which the WRAM-B master is set to the DSP and the offset is 
set to 0). 
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To use the DSP block for the first time after the system reset, perform step 1 and 2 (it doesn't matter which 
step is performed first), then perform step 3. For the second and subsequent times the DSP is used, the 
DSP biock can be initiaiized (with the exception of the DSP interface register) just by performing step 3. 

To initiaiize the DSP interface register, foiiow the procedure shown beiow after getting to step 3-ii in the 
procedures above. 

1. Write Os to aii the PRIEO-2 bits in the DSP configuration register. 

2. Write 0x0000 to the DSP semaphore register (DSP_PSEM). 

3. Write OxFFFF to the DSP semaphore ciear register (DSP_PCLEAR). 

4. Perform a dummy read of DSP repiy registers 0-2 (DSP_REPx), one by one. 
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23 NAND Flash Memory 

The TWL includes NAND flash memory for saving images and downioaded appiications. 

The TWL’s buiit-in NAND fiash memory has the foiiowing characteristics. 

• Capacity is 256 MB 

• Read speeds vary between 0.8 and 4.0 MB/s 

• Write speeds vary between 0.3 and 2.4 MB/s 

There is comparativeiy iittie variation in read speeds over muitipie reads; the variation in write speeds over 
muitipie writes is comparativeiy high. 

NAND fiash memory degrades with repeated reads and writes, and the greater the number of accesses, 
the more often iatency wiii occur (the iatency can be as much as 13 miiiiseconds per 512-byte chunk of 
data). This has no impact on write speed. 

Note: On rare occasions, the SDK wiii insert waits of 2 to 13 miiiiseconds regardiess of whether NAND 
fiash memory degradation exists. 

Furthermore, the performance of both reads and writes wiii be markediy reduced if the fiie pointers are not 
4-byte aiigned. 

NAND fiash memory and SD Memory Cards cannot be accessed at the same time because these two 
components share the same interface. 

When accessing NAND fiash memory, be sure to use the API that has been provided in the SDK. 
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24 SD Memory Cards 

The TWL comes with one SD Memory Card slot. The TWL’s SD Memory Card slot has the following 
features: 

• The supported media are (1) SD Memory Cards and (2) SDHC Memory Cards with capacities between 
2 and 32 GB. 

• SPI mode, encrypted authentication (CPRM / Content Protection for Recordable Media), and high¬ 
speed mode are not supported . (Even if high-speed memory card is used, it is not possible to access 
the cards faster than the speeds shown below.) 

• Maximum read speed: 6.0 MB/s 

• Maximum write speed: 2.4 MB/s 

Images and NAND applications can be backed up on SD Memory Cards. The file system supports the SD 
standard format. 

In addition to the standard access, applications can perform operations using insertion and removal of an 
SD Memory Card as a trigger. Applications can also look up the write-protection state of a card. 

The access speeds depend not only on the host’s control, but also on the control of the SD Card’s internal 
controller. As a result, the access speeds will vary from one SD Memory Card to another. 

miniSD and microSD cards can be accessed by using an SD Card adapter. However, inserting a microSD 
card into a miniSD adapter, and then inserting that into an SD Card adapter is prohibited, and data in such 
“doubly nested” cards may not always be accessed correctly. 

Read and write performance will both be markedly reduced if the file pointers are not 4-byte aligned. 

NAND flash memory and SD Memory Cards cannot be accessed at the same time because these two 
components share the same interface. 

When accessing SD Memory Cards that have been inserted into the slot, be sure to use the API provided 
in the SDK. 
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Appendix A. Register List 

A.1 Addresses 0x04000000 and Higher 


Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X000 

DISPCNT 

Z9 

2D Graphics Engine A dispiay controi 

0X002 

0X004 

DISPSTAT 

15 

Dispiay status 

0X006 

VCOUNT 

1J_ 

V count comparison 

0X008 

BGOCNT 

105 

2D Graphics Engine A BGO controi 

OXOOA 

BG1CNT 

105 

2D Graphics Engine A BG1 controi 

OXOOC 

BG2CNT 

107 

2D Graphics Engine A BG2 controi 

OXOOE 

BG3CNT 

107 

2D Graphics Engine A BG3 controi 

0X010 

BGOHOFS 

129 

2D Graphics Engine A BGO dispiay H offset 

0X012 

BGOVOFS 

129 

2D Graphics Engine A BGO dispiay V offset 

0X014 

BG1HOFS 

129 

2D Graphics Engine A BG1 dispiay H offset 

0X016 

BG1VOFS 

129 

2D Graphics Engine A BG1 dispiay V offset 

0X018 

BG2HOFS 

129 

2D Graphics Engine A BG2 dispiay H offset 

0X01A 

BG2VOFS 

129 

2D Graphics Engine A BG2 dispiay V offset 

0X01C 

BG3HOFS 

129 

2D Graphics Engine A BG3 dispiay H offset 

0X01 E 

BG3VOFS 

129 

2D Graphics Engine A BG3 dispiay V offset 

0X020 

BG2PA 

132 

2D Graphics Engine A BG2 affine transformation 
parameters (same iine X-direction reference shift dx) 

0X022 

BG2PB 

132 

2D Graphics Engine A BG2 affine transformation 
parameters (next iine X-direction reference shift dmx) 

0X024 

BG2PC 

132 

2D Graphics Engine A BG2 affine transformation 
parameters (same iine Y-direction reference shift dy) 

0X026 

BG2PD 

132 

2D Graphics Engine A BG2 affine transformation 
parameters (next iine Y-direction reference shift dmy) 

0X028 

BG2X 

131 

2D Graphics Engine A BG2 reference start point 

0X02A 

(x coordinate) 

0X02C 

BG2Y 

131 

2D Graphics Engine A BG2 reference start point 

0X02E 

(y coordinate) 

0X030 

BG3PA 

132 

2D Graphics Engine A BG3 affine transformation 
parameters (same iine X-direction reference shift dx) 

0X032 

BG3PB 

132 

2D Graphics Engine A BG3 affine transformation 
parameters (next iine X-direction reference shift dmx) 

0X034 

BG3PC 

132 

2D Graphics Engine A BG3 affine transformation 
parameters (same iine Y-direction reference shift dy) 

0X036 

BG3PD 

132 

2D Graphics Engine A BG3 affine transformation 
parameters (next iine Y-direction reference shift dmy) 

0X038 

BG3X 

131 

2D Graphics Engine A BG3 reference start point 

0X03A 

(x coordinate) 

0X03C 

BG3Y 

131 

2D Graphics Engine A BG3 reference start point 

0X03E 

(y coordinate) 

0X040 

WINOH 

167 

2D Graphics Engine A window 0 H size 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X042 

WIN1H 

167 

2D Graphics Engine A window 1 H size 

0X044 

WINOV 

167 

2D Graphics Engine A window 0 V size 

0X046 

WIN1V 

167 

2D Graphics Engine A window 1 V size 

0X048 

WININ 

166 

2D Graphics Engine A window inside 

0X04A 

WINOUT 

166 

2D Graphics Engine A window outside 

0X04C 

MOSAIC 

174 

2D Graphics Engine A mosaic size 

0X04E 




0X050 

BLDCNT 

170 

2D Graphics Engine A coior speciai effects 

0X052 

BLDALPHA 

172 

2D Graphics Engine A aipha biending factor 

0X054 

BLDY 

173 

2D Graphics Engine A brightness change factor 

0X056 




0X058 




0X05A 




0X05C 




0X05 E 




0X060 

DISP3DCNT 

179 

3D dispiay controi 

0X062 




0X064 

DISPCAPCNT 

21 

Dispiay capture 

0X066 

0X068 

DISP_MMEM_FIFO 

89 

Main memory dispiay FIFO 

0X06A 

0X06C 

MASTER_BRIGHT 

95 

Image output A master brightness 

0X06 E 




0X070 




0X072 




0X074 




0X076 




0X078 




0X07A 




0X07C 




0X07E 




0X080 




0X082 




0X084 




0X086 




0X088 




0X08A 




0X08C 




0X08 E 




0X090 




0X092 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X094 




0X096 




0X098 




0X09A 




0X09C 




0X09E 




OXOAO 




0X0A2 




0X0A4 




0X0A6 




0X0A8 




OXOAA 




OXOAC 




OXOAE 




OXOBO 

DMAOSAD 

297 

DM AO source address 

0X0B2 

0X0B4 

DMAODAD 

297 

DMAO destination address 

0X0B6 

0X0B8 

DMAOCNT 

298 

DMAO controi 

OXOBA 

OXOBC 

DMA1SAD 

297 

DMA1 source address 

OXOBE 

OXOCO 

DMA1DAD 

297 

DMA1 destination address 

0X0C2 

0X0C4 

DMA1CNT 

298 

DMA1 controi 

0X0C6 

0X0C8 

DMA2SAD 

297 

DMA2 source address 

OXOCA 

OXOCC 

DMA2DAD 

297 

DMA2 destination address 

OXOCE 

OXODO 

DMA2CNT 

298 

DMA2 controi 

0X0 D2 

0X0D4 

DMA3SAD 

297 

DM A3 source address 

0X0D6 

0X0 D8 

DMA3DAD 

297 

DM A3 destination address 

0X0 DA 

0X0 DC 

DMA3CNT 

298 

DMA3 controi 

0X0 DE 

0X0 EO 




0X0 E2 




0X0 E4 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X0E6 




0X0 E8 




OXOEA 




OXOEC 




OXOEE 




0X0 FO 




0X0 F2 




0X0 F4 




0X0 F6 




0X0 F8 




0X0 FA 




OXOFC 




OXOFE 




0X100 

TM0CNT_L 

309 

Timer 0 counter 

0X102 

TM0CNT_H 

309 

Timer 0 controi 

0X104 

TM1CNT_L 

310 

Timer 1 counter 

0X106 

TM1CNT_H 

310 

Timer 1 controi 

0X108 

TM2CNT_L 

310 

Timer 2 counter 

0X1OA 

TM2CNT_H 

310 

Timer 2 controi 

0X1OC 

TM3CNT_L 

310 

Timer 3 counter 

0X1OE 

TM3CNT_H 

310 

Timer 3 controi 

0X110 




0X112 




0X114 




0X116 




0X118 




0X11A 




0X11C 




0X1 IE 




0X120 




0X122 




0X124 




0X126 




0X128 




0X12A 




0X12C 




0X12E 




0X130 

KEYINPUT 

329 

Key input 

0X132 

KEYCNT 

330 

Key controi 

0X134 




0X136 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 













































































































0X16E 




0X170 




0X172 




0X174 




0X176 




0X178 




0X17A 




0X17C 




0X17E 




0X180 




0X182 




0X184 




0X186 




0X188 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 













































0X1 AO 




0X1A2 




0X1A4 




0X1A6 




0X1A8 




0X1AA 




0X1 AC 




0X1AE 




















0X1B8 




0X1 BA 




0X1BC 




0X1 BE 




0X1 CO 




0X1C2 




0X1C4 




0X1C6 




0X1C8 




0X1CA 




0X1CC 




0X1CE 




0X1 DO 




0X1D2 




0X1D4 




0X1 D6 




0X1 D8 




0X1 DA 





TWL-06-0017-001-D 
Released: February 16, 2009 


388 


© 2008-2009 Nintendo 
CONFIDENTIAL 













TWL Programming Manual 


Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X1 DC 




0X1 DE 




0X1EO 




0X1 E2 




0X1E4 




0X1E6 




0X1E8 




0X1 EA 




0X1 EC 




0X1 EE 




0X1FO 




0X1 F2 




0X1F4 




0X1 F6 




0X1F8 




0X1 FA 




0X1FC 




0X1FE 




0X200 




0X202 




0X204 

EXMEMCNT 

20 

External memory control 

0X206 




0X208 

IME 

311 

Interrupt master flag 

0X20A 




0X20C 




0X20 E 




0X210 

IE 

312 

Interrupt enable flag 

0X212 

0X214 

IF 

314 

Interrupt request flag 

0X216 

0X218 




0X21A 




0X21C 




0X21 E 




0X220 




0X222 




0X224 




0X226 




0X228 




0X22A 




0X22C 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X22 E 




0X230 




0X232 




0X234 




0X236 




0X238 




0X23A 




0X23C 




0X23 E 




0X240 

VRAMCNT 

30 

RAM bank control 0 

0X242 

0X244 

WVRAMCNT 

33 

RAM bank control 1 

0X246 

0X248 

VRAM_HI_CNT 

36 

RAM bank control 2 

0X24A 




0X24C 




0X24E 




0X250 




0X252 




0X254 




0X256 




0X258 




0X25A 




0X25C 




0X25 E 




0X260 




0X262 




0X264 




0X266 




0X268 




0X26A 




0X26C 




0X26 E 




0X270 




0X272 




0X274 




0X276 




0X278 




0X27A 




0X27C 




0X27E 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X280 

DIVCNT 

323 

Divider controi 

0X282 




0X284 




0X286 




0X288 




0X28A 




0X28C 




0X28 E 




0X290 

DIV_NUMER 

323 

Numerator 

0X292 

0X294 

0X296 

0X298 

DIV_DENOM 

323 

Denominator 

0X29A 

0X29C 

0X29 E 

0X2A0 

DIV_RESULT 

323 

Quotient 

0X2A2 

0X2A4 

0X2A6 

0X2A8 

DIVREM_RESULT 

323 

Remainder 

0X2AA 

0X2AC 

0X2AE 

0X2B0 

SQRTCNT 

326 

Square root unit controi 

0X2B2 




0X2B4 

SQRT_RESULT 

326 

Square root unit resuit 

0X2B6 

0X2B8 

SQRT_PARAM 

326 

Square root unit data 

0X2BA 

0X2BC 

0X2BE 

0X2C0 




0X2C2 




0X2C4 




0X2C6 




0X2C8 




0X2CA 




0X2CC 




0X2CE 




0X2D0 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X2D2 




0X2 D4 




0X2D6 




0X2 D8 




0X2 DA 




0X2 DC 




0X2 DE 




0X2 EO 




0X2 E2 




0X2 E4 




0X2 E6 




0X2 E8 




0X2EA 




0X2 EC 




0X2 EE 




0X2 FO 




0X2 F2 




0X2 F4 




0X2 F6 




0X2 F8 




0X2 FA 




0X2FC 




0X2 FE 




0X300 




0X302 




0X304 

POWCNT 

Z8 

Power control 

0X306 




0X308 




0X30A 




0X30C 




0X30 E 




0X310 




0X312 




0X314 




0X316 




0X318 




0X31A 




0X31C 




0X31 E 




0X320 

RDLINES_COUNT 

292 

Rendering minimum fiii 

0X322 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X324 




0X326 




0X328 




0X32A 




0X32C 




0X32 E 




0X330 

EDGE_COLOR_0_L 

284 

Edge marking color 

(Polygon ID’s 3 upper bits are 000) 

0X332 

EDGE_COLOR_0_H 

284 

Edge marking color 

(Polygon ID’s 3 upper bits are 001) 

0X334 

EDGE_COLOR_1_L 

284 

Edge marking color 

(Polygon ID’s 3 upper bits are 010) 

0X336 

EDGE_COLOR_1_H 

284 

Edge marking color 

(Polygon ID’s 3 upper bits are 011) 

0X338 

EDGE_COLOR_2_L 

284 

Edge marking color 

(Polygon ID’s 3 upper bits are 100) 

0X33A 

EDGE_COLOR_2_H 

284 

Edge marking color 

(Polygon ID’s 3 upper bits are 101) 

0X33C 

EDGE_COLOR_3_L 

284 

Edge marking color 

(Polygon ID’s 3 upper bits are 110) 

0X33 E 

EDGE_COLOR_3_H 

284 

Edge marking color 

(Polygon ID’s 3 upper bits are 111) 

0X340 

ALPHA_TEST_REF 

283 

Alpha test 

0X342 




0X344 




0X346 




0X348 




0X34A 




0X34C 




0X34E 




0X350 

CLEAR_COLOR 

256 

Color buffer initial value 

0X352 

0X354 

CLEAR_DEptH 

256 

Depth buffer initial value 

0X356 

CLRIMAGE_OFFSET 

258 

Clear image offset 

0X358 

FOG_COLOR 

285 

Fog color 

0X35A 

0X35C 

FOG_OFFSET 

285 

Fog offset 

0X35E 




0X360 

FOG_TABLE_0_L 

286 

Fog density table (0,1) 

0X362 

FOG_TABLE_0_H 

286 

Fog density table (2, 3) 

0X364 

FOG_TABLE_1_L 

286 

Fog density table (4, 5) 

0X366 

FOG_TABLE_1_H 

286 

Fog density table (6, 7) 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X368 

FOG_TABLE_2_L 

286 

Fog density table (8, 9) 

0X36A 

FOG_TABLE_2_H 

286 

Fog density tabie (10, 11) 

0X36C 

FOG_TABLE_3_L 

286 

Fog density tabie (12, 13) 

0X36 E 

FOG_TABLE_3_H 

286 

Fog density tabie (14, 15) 

0X370 

FOG_TABLE_4_L 

286 

Fog density tabie (16, 17) 

0X372 

FOG_TABLE_4_H 

286 

Fog density tabie (18, 19) 

0X374 

FOG_TABLE_5_L 

286 

Fog density tabie (20, 21) 

0X376 

FOG_TABLE_5_H 

286 

Fog density tabie (22, 23) 

0X378 

FOG_TABLE_6_L 

286 

Fog density tabie (24, 25) 

0X37A 

FOG_TABLE_6_H 

286 

Fog density tabie (26, 27) 

0X37C 

FOG_TABLE_7_L 

286 

Fog density tabie (28, 29) 

0X37E 

FOG_TABLE_7_H 

286 

Fog density tabie (30, 31) 

0X380 

TOON_TABLE_0_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 0) 

0X382 

TOON_TABLE_0_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 1) 

0X384 

TOON_TABLE_1_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 2) 

0X386 

TOON_TABLE_1_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 3) 

0X388 

TOON_TABLE_2_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 4) 

0X38A 

TOON_TABLE_2_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 5) 

0X38C 

TOON_TABLE_3_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 6) 

0X38E 

TOON_TABLE_3_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 7) 

0X390 

TOON_TABLE_4_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 8) 

0X392 

TOON_TABLE_4_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 9) 

0X394 

TOON_TABLE_5_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 10) 

0X396 

TOON_TABLE_5_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 11) 

0X398 

TOON_TABLE_6_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 12) 

0X39A 

TOON_TABLE_6_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 13) 

0X39C 

TOON_TABLE_7_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 14) 

0X39E 

TOON_TABLE_7_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 15) 

0X3A0 

TOON_TABLE_8_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 16) 

0X3A2 

TOON_TABLE_8_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 17) 

0X3A4 

TOON_TABLE_9_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 18) 

0X3A6 

TOON_TABLE_9_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 19) 

0X3A8 

TOON_TABLE_10_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 20) 

0X3AA 

TOON_TABLE_10_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 21) 

0X3AC 

TOON_TABLE_11_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 22) 

0X3AE 

TOON_TABLE_11_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 23) 

0X3B0 

TOON_TABLE_12_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 24) 

0X3B2 

TOON_TABLE_12_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 25) 

0X3B4 

TOON_TABLE_13_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 26) 

0X3B6 

TOON_TABLE_13_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 27) 

0X3B8 

TOON_TABLE_14_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 28) 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X3BA 

TOON_TABLE_14_H 

266 

Toon table (RGB conversion value when brightness is 29) 

0X3BC 

TOON_TABLE_15_L 

266 

Toon tabie (RGB conversion vaiue when brightness is 30) 

0X3BE 

TOON_TABLE_15_H 

266 

Toon tabie (RGB conversion vaiue when brightness is 31) 

0X3C0 




0X3C2 




0X3C4 




0X3C6 




0X3C8 




0X3CA 




0X3CC 




0X3CE 




0X3 DO 




0X3 D2 




0X3 D4 




0X3 D6 




0X3 D8 




0X3 DA 




0X3 DC 




0X3 DE 




0X3 EO 




0X3 E2 




0X3 E4 




0X3 E6 




0X3 E8 




0X3EA 




0X3 EC 




0X3 EE 




0X3 FO 




0X3 F2 




0X3 F4 




0X3 F6 




0X3 F8 




0X3 FA 




0X3FC 




0X3 FE 




0X400 

GXFIFO 

192 

Geometry command FIFO 

0X402 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X404 

GXFIFO image 



0X406 



0X408 



0X40A 



0X40C 



0X40 E 



0X410 



0X412 



0X414 



0X416 



0X418 



0X41A 



0X41C 



0X41 E 



0X420 



0X422 



0X424 



0X426 



0X428 



0X42A 



0X42C 



0X42 E 



0X430 



0X432 



0X434 



0X436 



0X438 



0X43A 



0X43C 



0X43 E 



0X440 

MTX_MODE 

206 

Current matrix mode setting 

0X442 

0X444 

MTX_PUSH 

211 

Push current matrix onto the stack 

0X446 

0X448 

MTX_POP 

211 

Pop current matrix from the stack 

0X44A 

0X44C 

MTX_STORE 

212 

Store current matrix in specified position in the stack 

0X44E 

0X450 

MTX_RESTORE 

212 

Read matrix from specified position in the stack 

0X452 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X454 

MTX IDENTITY 

207 

Initialize unit matrix 

0X456 


0X458 

MTX_LOAD_4x4 

207 

Set 4x4 matrix 

0X45A 

0X45C 

MTX_LOAD_4x3 

207 

Set 4x3 matrix 

0X45 E 

0X460 

MTX_MULT_4x4 

208 

Muitipiy by 4x4 matrix 

0X462 

0X464 

MTX_MULT_4x3 

208 

Muitipiy by 4x3 matrix 

0X466 

0X468 

MTX_MULT_3x3 

209 

Muitipiy by 3x3 matrix 

0X46A 

0X46C 

MTX_SCALE 

210 

Muitipiy by the Scaie matrix 

0X46 E 

0X470 

MTX_TRANS 

209 

Muitipiy by the Transiation matrix 

0X472 

0X474 




0X476 




0X478 




0X47A 




0X47C 




0X47E 




0X480 

COLOR 

226 

Vertex coior 

0X482 

0X484 

NORMAL 

227 

Normai vector 

0X486 

0X488 

TEXCOORD 

231 

Texture coordinates 

0X48A 

0X48C 

VTX_16 

227 

Vertex coordinates 

0X48 E 

0X490 

VTX_10 

228 

Vertex coordinates 

0X492 

0X494 

VTX XY 

228 

Vertex XY coordinates 

0X496 


0X498 

VTX XZ 

228 

Vertex XZ coordinates 

0X49A 


0X49C 

VTX_YZ 

228 

Vertex YZ coordinates 

0X49 E 

0X4A0 

VTX_DIFF 

229 

Vertex coordinates difference vaiue specification 

0X4A2 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X4A4 

POLYGON_ATTR 

221 

Polygon-related attribute values 

0X4A6 

0X4A8 

TEXIMAGE_PARAM 

232 

Texture parameters 

0X4AA 

0X4AC 

TEXPLTT_BASE 

237 

Texture palette base address 

0X4AE 

0X4B0 




0X4B2 




0X4B4 




0X4B6 




0X4B8 




0X4BA 




0X4BC 




0X4BE 




0X4C0 

DIF_AMB 

217 

Material’s diffuse and ambient coiors 

0X4C2 

0X4C4 

SPE_EMI 

217 

Materiai’s specuiar refiection and emitted iight coiors 

0X4C6 

0X4C8 

LIGHT_VECTOR 

214 

Light direction vector 

0X4CA 

0X4CC 

LIGHT_COLOR 

214 

Light coior 

0X4CE 

0X4D0 

SHININESS 

218 

Specuiar refiection shininess tabie 

0X4D2 

0X4D4 




0X4D6 




0X4D8 




0X4DA 




0X4 DC 




0X4DE 




0X4E0 




0X4E2 




0X4E4 




0X4E6 




0X4E8 




0X4EA 




0X4EC 




0X4EE 




0X4F0 




0X4F2 




0X4F4 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X4F6 




0X4F8 




0X4FA 




0X4FC 




0X4FE 




0X500 

BEGIN_VTXS 

225 

Vertex list start 

0X502 

0X504 

END_VTXS 

226 

Vertex list end 

0X506 

0X508 




0X50A 




0X50C 




0X50E 




0X510 




0X512 




0X514 




0X516 




0X518 




0X51A 




0X51C 




0X51 E 




0X520 




0X522 




0X524 




0X526 




0X528 




0X52A 




0X52C 




0X52 E 




0X530 




0X532 




0X534 




0X536 




0X538 




0X53A 




0X53C 




0X53 E 




0X540 

SWAP_BUFFERS 

203 

Swap data group 

0X542 

0X544 




0X546 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X548 




0X54A 




0X54C 




0X54E 




0X550 




0X552 




0X554 




0X556 




0X558 




0X55A 




0X55C 




0X55 E 




0X560 




0X562 




0X564 




0X566 




0X568 




0X56A 




0X56C 




0X56 E 




0X570 




0X572 




0X574 




0X576 




0X578 




0X57A 




0X57C 




0X57E 




0X580 

VIEWPORT 

205 

Viewport 

0X582 

0X584 




0X586 




0X588 




0X58A 




0X58C 




0X58 E 




0X590 




0X592 




0X594 




0X596 




0X598 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X59A 




0X59C 




0X59E 




0X5A0 




0X5A2 




0X5A4 




0X5A6 




0X5A8 




0X5AA 




0X5AC 




0X5AE 




0X5B0 




0X5B2 




0X5B4 




0X5B6 




0X5B8 




0X5BA 




0X5BC 




0X5BE 




0X5C0 

BOX_TEST 

241 

Box test 

0X5C2 

0X5C4 

POS_TEST 

243 

Position coordinate test 

0X5C6 

0X5C8 

VEC_TEST 

243 

Direction vector test 

0X5CA 

0X5CC 




0X5CE 




0X5D0 




0X5 D2 




0X5D4 




0X5D6 




0X5D8 




0X5 DA 




0X5 DC 




0X5 DE 




0X5 EO 




0X5 E2 




0X5 E4 




0X5 E6 




0X5E8 




0X5EA 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X5EC 




0X5EE 




0X5 FO 




0X5 F2 




0X5 F4 




0X5 F6 




0X5 F8 




0X5 FA 




0X5FC 




0X5FE 




0X600 

GXSTAT 

245 

Geometry engine status 

0X602 

0X604 

LISTRAM_COUNT 

247 

Polygon list RAM count 

0X606 

VTXRAM_COUNT 

247 

Vertex RAM count 

0X608 




0X60A 




0X60C 




0X60E 




0X610 

DISP_1 DOT_DEptH 

224 

1-dot poiygon dispiay boundary depth vaiue 

0X612 




0X614 




0X616 




0X618 




0X61A 




0X61C 




0X61 E 




0X620 

POS_RESULT_X 

243 

Resuit of position coordinate test (ciip coordinate X 
component) 

0X622 

0X624 

POS_RESULT_Y 

243 

Resuit of position coordinate test (ciip coordinate Y 
component) 

0X626 

0X628 

POS_RESULT_Z 

243 

Resuit of position coordinate test (ciip coordinate Z 
component) 

0X62A 

0X62C 

POS_RESULT_W 

243 

Resuit of position coordinate test (ciip coordinate W 
component) 

0X62E 

0X630 

VEC_RESULT_X 

244 

Resuit of direction vector test (X component) 

0X632 

VEC_RESULT_Y 

244 

Resuit of direction vector test (Y component) 

0X634 

VEC_RESULT_Z 

244 

Resuit of direction vector test (Z component) 

0X636 




0X638 




0X63A 




0X63C 
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Offset 

ARM9 

Register Name 

Page 

Description 

0X63 E 




0X640 

CLIPMTX_RESULT_0 

213 

Current clip coordinate matrix (eiement mO) 

0X642 

0X644 

CLIPMTX_RESULT_1 

213 

Current dip coordinate matrix (eiement ml) 

0X646 

0X648 

CLIPMTX_RESULT_2 

213 

Current dip coordinate matrix (eiement m2) 

0X64A 

0X64C 

CLIPMTX_RESULT_3 

213 

Current dip coordinate matrix (eiement m3) 

0X64E 

0X650 

CLIPMTX_RESULT_4 

213 

Current dip coordinate matrix (eiement m4) 

0X652 

0X654 

CLIPMTX_RESULT_5 

213 

Current dip coordinate matrix (eiement m5) 

0X656 

0X658 

CLIPMTX_RESULT_6 

213 

Current dip coordinate matrix (eiement m6) 

0X65A 

0X65C 

CLIPMTX_RESULT_7 

213 

Current dip coordinate matrix (eiement m7) 

0X65E 

0X660 

CLIPMTX_RESULT_8 

213 

Current dip coordinate matrix (eiement m8) 

0X662 

0X664 

CLIPMTX_RESULT_9 

213 

Current dip coordinate matrix (eiement m9) 

0X666 

0X668 

CLIPMTX_RESULT_10 

213 

Current dip coordinate matrix (eiement mIO) 

0X66A 

0X66C 

CLIPMTX_RESULT_11 

213 

Current dip coordinate matrix (eiement mil) 

0X66E 

0X670 

CLIPMTX_RESULT_12 

213 

Current dip coordinate matrix (eiement ml2) 

0X672 

0X674 

CLIPMTX_RESULT_13 

213 

Current dip coordinate matrix (eiement ml 3) 

0X676 

0X678 

CLIPMTX_RESULT_14 

213 

Current dip coordinate matrix (eiement ml4) 

0X67A 

0X67C 

CLIPMTX_RESULT_15 

213 

Current dip coordinate matrix (eiement ml 5) 

0X67E 

0X680 

VECMTX_RESULT_0 

213 

Current direction vector matrix (eiement mO) 

0X682 

0X684 

VECMTX_RESULT_1 

213 

Current direction vector matrix (eiement ml) 

0X686 

0X688 

VECMTX_RESULT_2 

213 

Current direction vector matrix (eiement m2) 

0X68A 

0X68C 

VECMTX_RESULT_3 

213 

Current direction vector matrix (eiement m3) 

0X68E 
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Address® 

Offset 

ARM9 

Register Name 

Page 

Description 

0X690 

VECMTX_RESULT_4 

213 

Current direction vector matrix (eiement m4) 

0X692 

0X694 

VECMTX_RESULT_5 

213 

Current direction vector matrix (eiement m5) 

0X696 

0X698 

VECMTX_RESULT_6 

213 

Current direction vector matrix (eiement m6) 

0X69A 

0X69C 

VECMTX_RESULT_7 

213 

Current direction vector matrix (eiement m7) 

0X69 E 

0X6A0 

VECMTX_RESULT_8 

213 

Current direction vector matrix (eiement m8) 

0X6A2 

0X6A4 




0X6A6 




0X6A8 




0X6AA 




0X6AC 




0X6AE 




0X6B0 




0X6B2 




0X6B4 




0X6B6 




0X6B8 




0X6BA 




0X6BC 




0X6BE 




0X6C0 




0X6C2 




0X6C4 




0X6C6 




0X6C8 




0X6CA 




0X6CC 




0X6CE 




0X6D0 




0X6D2 




0X6 D4 




0X6D6 




0X6D8 




0X6 DA 




0X6 DC 




0X6 DE 




0X6E0 
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Offset 

ARM9 

Register Name 

Page 

Description 

0X6 E2 




0X6 E4 




0X6 E6 




0X6E8 




0X6EA 




0X6EC 




0X6 EE 




0X6 FO 




0X6 F2 




0X6 F4 




0X6 F6 




0X6 F8 




0X6 FA 




0X6FC 




0X6 FE 





a. This indicates the offset vaiue from 0x04000000. 
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Address 

Offset 

ARMS 

Register Name 

Page 

Explanation 

0X000 

DB_DISPCNT 


2D Graphics Engine B dispiay controi 

0X002 

0X004 




0X006 




0X008 

DB_BG0CNT 

105 

2D Graphics Engine B BGO controi 

OXOOA 

DB_BG1CNT 

105 

2D Graphics Engine B BG1 controi 

OXOOC 

DB_BG2CNT 

107 

2D Graphics Engine B BG2 controi 

OXOOE 

DB_BG3CNT 

107 

2D Graphics Engine B BG3 controi 

0X010 

DB_BGOHOFS 

129 

2D Graphics Engine B BGO dispiay H offset 

0X012 

DB_BGOVOFS 

129 

2D Graphics Engine B BGO dispiay V offset 

0X014 

DB_BG1HOFS 

129 

2D Graphics Engine B BG1 dispiay H offset 

0X016 

DB_BG1VOFS 

129 

2D Graphics Engine B BG1 dispiay V offset 

0X018 

DB_BG2HOFS 

129 

2D Graphics Engine B BG2 dispiay H offset 

0X01A 

DB_BG2VOFS 

129 

2D Graphics Engine B BG2 dispiay V offset 

0X01C 

DB_BG3HOFS 

129 

2D Graphics Engine B BG3 dispiay H offset 

0X01E 

DB_BG3VOFS 

129 

2D Graphics Engine B BG3 dispiay V offset 

0X020 

DB_BG2PA 

132 

2D Graphics Engine B BG2 affine transformation 
parameters (same iine X-direction reference shift dx) 

0X022 

DB_BG2PB 

132 

2D Graphics Engine B BG2 affine transformation 
parameters (next iine X-direction reference shift dmx) 

0X024 

DB_BG2PC 

132 

2D Graphics Engine B BG2 affine transformation 
parameters (same iine Y-direction reference shift dy) 

0X026 

DB_BG2PD 

132 

2D Graphics Engine B BG2 affine transformation 
parameters (next iine Y-direction reference shift dmy) 

0X028 

DB_BG2X 

131 

2D Graphics Engine B BG2 reference start point 

0X02A 

(x coordinate) 

0X02C 

DB_BG2Y 

131 

2D Graphics Engine B BG2 reference start point 

0X02 E 

(y coordinate) 

0X030 

DB_BG3PA 

132 

2D Graphics Engine B BG3 affine transformation 
parameters (same iine X-direction reference shift dx) 

0X032 

DB_BG3PB 

132 

2D Graphics Engine B BG3 affine transformation 
parameters (next iine X-direction reference shift dmx) 

0X034 

DB_BG3PC 

132 

2D Graphics Engine B BG3 affine transformation 
parameters (same iine Y-direction reference shift dy) 

0X036 

DB_BG3PD 

132 

2D Graphics Engine B BG3 affine transformation 
parameters (next iine Y-direction reference shift dmy) 

0X038 

DB_BG3X 

131 

2D Graphics Engine B BG3 reference start point 

0X03A 

(x coordinate) 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X03C 

DB BG3Y 

131 

2D Graphics Engine B BG3 reference start point 

0X03E 



(y coordinate) 

0X040 

DB_WIN0H 

167 

2D Graphics Engine B window OH size 

0X042 

DB_WIN1H 

167 

2D Graphics Engine B window 1H size 

0X044 

DB_WIN0V 

167 

2D Graphics Engine B window OV size 

0X046 

DB_WIN1V 

167 

2D Graphics Engine B window IV size 

0X048 

DB_WININ 

166 

2D Graphics Engine B window inside 

0X04A 

DB_WINOUT 

166 

2D Graphics Engine B window outside 

0X04C 

DB_MOSAIC 

174 

2D Graphics Engine B mosaic size 

0X04E 




0X050 

DB_BLDCNT 

170 

2D Graphics Engine B coior speciai effects 

0X052 

DB_BLDALPHA 

172 

2D Graphics Engine B aipha biending factor 

0X054 

DB_BLDY 

173 

2D Graphics Engine B brightness conversion factor 

0X056 




0X058 




0X05A 




0X05C 




0X05E 




0X060 




0X062 




0X064 




0X066 




0X068 




0X06A 




0X06C 

DB_MASTER_BRIGHT 

95 

Image output B master brightness 
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A.3 Addresses 0x04004000 and Higher (TWL Extension-Related) 


Address 

Offset 

ARMS 

Register Name 

Page 

Explanation 

0X000 

SCFG_A9ROM 


ROM Status 

0X002 




0X004 

SCFG_CLK 


New Block Clock Control 

0X006 

SCFG_RST 


New Block Reset Control 

0X008 

SCFG_EXT 


Extended Features Control 

OXOOA 

OXOOC 




OXOOE 




0X010 

SCFG_MC 


Memory Card Interface Status 

0X012 




0X014 




0X016 




0X018 




0X01A 




0X01C 




0X01E 




0X020 




0X022 




0X024 




0X026 




0X028 




0X02A 




0X02C 




0X02 E 




0X030 




0X032 




0X034 




0X036 




0X038 




0X03A 




0X03C 




0X03E 




0X040 

MBK1 


WRAM Bank Control Register 1 

0X042 

0X044 

MBK2 


WRAM Bank Control Register 2 

0X046 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X048 

MBK3 


WRAM Bank Control Register 3 

0X04A 

0X04C 

MBK4 


WRAM Bank Control Register 4 

0X04E 

0X050 

MBK5 


WRAM Bank Controi Register 5 

0X052 

0X054 

MBK6 


WRAM Bank Controi Register 6 

0X056 

0X058 

MBK7 


WRAM Bank Controi Register 7 

0X05A 

0X05C 

MBK8 


WRAM Bank Controi Register 8 

0X05E 

0X060 

MBK9 


WRAM Bank Controi Register 9 

0X062 

0X064 




0X066 




0X068 




0X06A 




0X06C 




0X06E 




0X070 




0X072 




0X074 




0X076 




0X078 




0X07A 




0X07C 




0X07E 




0X080 




0X082 




0X084 




0X086 




0X088 




0X08A 




0X08C 




0X08E 








0X090 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X092 




0X094 




0X096 




0X098 




0X09A 




0X09C 




0X09E 




OXOAO 




0X0A2 




0X0A4 




0X0A6 




0X0A8 




OXOAA 




OXOAC 




OXOAE 












0X0B4 








0X0B8 




OXOBA 




OXOBC 




OXOBE 












■BB 








0X0C8 




OXOCA 




OXOCC 




OXOCE 




0X0 DO 




0X0 D2 




0X0 D4 




0X0 D6 




0X0 D8 




0X0 DA 




0X0 DC 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

OXODE 




OXOEO 




0X0E2 




0X0 E4 




0X0E6 




0X0E8 




0X0 E A 




OXOEC 




0X0 EE 




OXOEO 




0X0 F2 




0X0 F4 




0X0F6 




0X0F8 




0X0 FA 




OXOEC 




OXOFE 




0X100 

NDMAGCNT 


NDMA Global Control 

0X102 


0X104 

NDMAOSAD 


NDMAO Source Address 

0X106 


0X108 

NDMAODAD 


NDMAO Destination Address 

0X1OA 


0X1OC 

NDMAOTCNT 


NDMAO Totai Words Transferred Count 

0X1OE 


0X110 

NDMAOWCNT 


NDMAO Word Count 

0X112 


0X114 

NDMAOBCNT 


NDMAO Block Transfer Interval 

0X116 


0X118 

NDMAOFDATA 


NDMAO Fill Data 

0X11A 


0X11C 

NDMAOCNT 


NDMAO Control 

0X1 IE 


0X120 

NDMA1SAD 


NDMA1 Source Address 

0X122 


0X124 

NDMA1DAD 


NDMA1 Destination Address 

0X126 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X128 

NDMA1TCNT 


NDMA1 Total Words Transferred Count 

0X12A 


0X12C 

NDMA1WCNT 


NDMA1 Word Count 

0X12E 


0X130 

NDMA1BCNT 


NDMA1 Block Transfer Interval 

0X132 


0X134 

NDMA1FDATA 


NDMA1 Fill Data 

0X136 


0X138 

NDMA1CNT 


NDMA1 Control 

0X13A 


0X13C 

NDMA2SAD 


NDMA2 Source Address 

0X13E 


0X140 

NDMA2DAD 


NDMA2 Destination Address 

0X142 


0X144 

NDMA2TCNT 


NDMA2 Totai Words Transferred Count 

0X146 


0X148 

NDMA2WCNT 


NDMA2 Word Count 

0X14A 


0X14C 

NDMA2BCNT 


NDMA2 Biock Transfer Intervai 

0X14E 


0X150 

NDMA2FDATA 


NDMA2 Fiii Data 

0X152 


0X154 

NDMA2CNT 


NDMA2 Controi 

0X156 


0X158 

NDMA3SAD 


NDMA3 Source Address 

0X15A 


0X15C 

NDMA3DAD 


NDMA3 Destination Address 

0X15E 


0X160 

NDMA3TCNT 


NDMA3 Totai Words Transferred Count 

0X162 


0X164 

NDMA3WCNT 


NDMA3 Word Count 

0X166 


0X168 

NDMA3BCNT 


NDMA3 Biock Transfer Intervai 

0X16A 


0X16C 

NDMA3FDATA 


NDMA3 Fiii Data 

0X16E 


0X170 

NDMA3CNT 


NDMA3 Controi 

0X172 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X174 




0X176 




0X178 




0X17A 




0X17C 




0X17E 




0X180 




0X182 




0X184 




0X186 




0X188 




0X18A 
































































0X1AA 




0X1 AC 




0X1AE 




0X1 BO 




0X1B2 




0X1B4 




0X1B6 




0X1B8 




0X1 BA 




0X1BC 




0X1 BE 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X1 CO 




0X1C2 




0X1C4 




0X1C6 




0X1C8 




0X1CA 




0X1CC 




0X1CE 




0X1 DO 




0X1 D2 




0X1 D4 




0X1 D6 




0X1 D8 




0X1 DA 




0X1 DC 




OXIDE 




0X1EO 




0X1E2 




0X1 E4 




0X1E6 




0X1 E8 




0X1EA 




0X1 EC 




0X1 EE 




0X1 FO 




0X1F2 




0X1 F4 




0X1F6 




0X1 F8 




0X1 FA 




0X1 FC 




0X1 FE 




0X200 

CAM_MCNT 


Camera Module Control | 

0X202 

CAM_CNT 


Camera Control 

0X204 

CAM_DAT 


Camera Data 

0X206 

0X208 




0X20A 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X20C 




0X20E 




0X210 

CAM_SOFS 


Camera Trimming Starting Position Setting 

0X212 

0X214 

CAM_EOFS 


Camera Trimming Ending Position Setting 

0X216 

0X218 




0X21A 




0X21C 




0X21E 




0X220 




0X222 




0X224 




0X226 




0X228 




0X22A 




0X22C 




0X22 E 




0X230 




0X232 




0X234 




0X236 




0X238 




0X23A 




0X23C 




0X23 E 




0X240 




0X242 




0X244 




0X246 




0X248 




0X24A 




0X24C 




0X24E 




0X250 




0X252 




0X254 




0X256 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X258 




0X25A 




0X25C 




0X25 E 




0X260 




0X262 




0X264 




0X266 




0X268 




0X26A 




0X26C 




0X26 E 




0X270 




0X272 




0X274 




0X276 




0X278 




0X27A 




0X27C 




0X27E 




0X280 




0X282 




0X284 




0X286 




0X288 




0X28A 




0X28C 




0X28 E 




0X290 




0X292 




0X294 




0X296 




0X298 




0X29A 




0X29C 




0X29 E 




0X2A0 




0X2A2 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X2A4 




0X2A6 




0X2A8 




0X2AA 




0X2AC 




0X2AE 




0X2B0 




0X2B2 




0X2B4 




0X2B6 




0X2B8 




0X2BA 




0X2BC 




0X2BE 




0X2C0 




0X2C2 




0X2C4 




0X2C6 




0X2C8 




0X2CA 




0X2CC 




0X2CE 




0X2 DO 




0X2 D2 




0X2 D4 




0X2 D6 




0X2 D8 




0X2 DA 




0X2 DC 




0X2DE 




0X2E0 




0X2 E2 




0X2 E4 




0X2E6 




0X2E8 




0X2 E A 




0X2EC 




0X2 EE 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X2 FO 




0X2 F2 




0X2 F4 




0X2 F6 




0X2F8 




0X2 FA 




0X2 FC 




0X2FE 




0X300 

DSP_PDATA 


DSP Transfer Data 

0X302 




0X304 

DSP_PADR 


DSP Transfer Address 

0X306 




0X308 

DSP_PCFG 


DSP Configuration 

0X30A 




0X30C 

DSP_PSTS 


DSP Status 

0X30 E 




0X310 

DSP_PSEM 


DSP Semaphore 

0X312 




0X314 

DSP_PMASK 


DSP Semaphore Mask 

0X316 




0X318 

DSP_PCLEAR 


DSP Semaphore Ciear 

0X31A 




0X31C 

DSP_SEM 


DSP Semaphore Data 

0X31E 




0X320 

DSP_CMD0 


DSP Command Register 0 

0X322 




0X324 

DSP_REP0 


DSP Repiy Register 0 

0X326 




0X328 

DSP_CMD1 


DSP Command Register 1 

0X32A 




0X32C 

DSP_REP1 


DSP Repiy Register 1 

0X32 E 




0X330 

DSP_CMD2 


DSP Command Register 2 

0X332 




0X334 

DSP_REP2 


DSP Repiy Register 2 

0X336 




0X338 




0X33A 
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Address 

Offset 

ARM9 

Register Name 

Page 

Explanation 

0X33C 




0X33 E 




0X340 




0X342 




0X344 




0X346 




0X348 




0X34A 




0X34C 




0X34E 




0X350 




0X352 




0X354 




0X356 




0X358 




0X35A 




0X35C 




0X35 E 




0X360 




0X362 




0X364 




0X366 




0X368 




0X36A 




0X36C 




0X36 E 




0X370 




0X372 




0X374 




0X376 




0X378 




0X37A 




0X37C 




0X37E 
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Appendix B. List of VRAM Data Capacities 

(Data capacity unit: bytes) 


Size 

8 

16 

32 

64 

128 

256 

256 

512 

512 

1024 

1024 


X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

Format 

8 

16 

32 

64 

128 

192 

256 

256 

512 

512 

1024 

16-Color Character 

32 

128 

512 

2K 

X 

X 

X 

X 

X 

X 

X 

256-Color Character 

64 

256 

IK 

4K 

X 

X 

X 

X 

X 

X 

X 

Direct Color Bitmap OBJ 

128 

512 

2K 

8K 

X 

X 

X 

X 

X 

X 

X 

Normal Character BG Screen 

X 

X 

X 

X 

X 

X 

2K 

4K 

8K 

X 

X 

Rotated Character BG Screen 

X 

X 

X 

X 

256 

X 

IK 

X 

4K 

X 

16K 

Extended/Rotated Character 
BG Screen 

X 

X 

X 

X 

512 

X 

2K 

X 

8K 

X 

32K 

256-Color Bitmap BG 

X 

X 

X 

X 

16K 

X 

64K 

128K 

256K 

X 

X 

Large Screen 256-Color 
Bitmap BG 

X 

X 

X 

X 

X 

X 

X 

X 

X 

512K 

X 

Direct Color Bitmap BG 

X 

X 

X 

X 

32K 

X 

128K 

256K 

512K 

X 

X 

Clear Color Image 

X 

X 

X 

X 

X 

96K 

X 

X 

X 

X 

X 

Clear Depth Image 

X 

X 

X 

X 

X 

96K 

X 

X 

X 

X 

X 

Display Capture 

X 

X 

X 

X 

32K 

96K 

X 

X 

X 

X 

X 

4-Color Texture 

16 

64 

256 

IK 

4K 

— 

16K 

— 

64K 

— 

256K 

16-Color Texture 

32 

128 

512 

2K 

8K 

— 

32K 

— 

128K 

— 

512K 

256-Color Texture 

64 

256 

IK 

4K 

16K 

— 

64K 

— 

256K 

512K 

X 

A3I5 Translucent Texture 

64 

256 

IK 

4K 

16K 

— 

64K 

— 

256K 

512K 

X 

A5I3 Translucent Texture 

64 

256 

IK 

4K 

16K 

— 

64K 

— 

256K 

512K 

X 

Direct Color Texture 

128 

512 

2K 

8K 

32K 

— 

128K 

— 

512K 

X 

X 

Compressed Texture Image 

16 

64 

256 

IK 

4K 

— 

16K 

— 

64K 

— 

256K 

Compressed Texture Index 

8 

32 

128 

512 

2K 

— 

8K 

— 

32K 

— 

128K 

Maximum No. of Compressed 
Texture Interpolation Palettes 

16 

64 

256 

IK 

4K 

— 

16K 

— 

64K 

(96K) 

(96K) 


X: Outside of specifications 

—: Omitted 

Boid: Maximum vaiue 

(): The maximum data vaiue exceeds the RAM capacity. Therefore the maximum usabie RAM capacity is 
specified. 
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Appendix C. Data Formats 

BG, OBJ Character Data 



15 14 13 12 

11 10 9 8 

7 6 5 4 

3 2 10 

16-color Character 

P3 

P2 

PI 

PO 

256-color Character 

PI 

PO 


Bitmap OBJ 



15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 

Direct Color Bitmap 
OBJ 

ALP 

HA 

BLUE 

GREEN 

RED 


BG Screen Data 



15 14 13 12 

11 

10 

9 8 

7 6 

5 

4 3 2 

1 

0 

Normal Character BG 
Screen 

Palette 

Vfllp 

Hflip 

Character name 

Rotate Character BG 
Screen 


Character name 

Expand/rotate 
Character BG Screen 

Palette 

Vfllp 

Hflip 

Character name 


Bitmap BG Data 



15 

14 

13 

12 

11 

10 

9 

8 

7 6 5 

4 

3 2 10 


256-color Bitmap BG 









Color No. 


Large Screen 

256-color Bitmap BG 









Color No. 


Direct Color Bitmap 
BG 

ALP 

HA 

BLUE 

GREEN 

RED 


Paiette Data 














d 

15 

14 

13 

12 

11 

10 

9 

8 7 6 

5 

4 3 2 1 

0 

BG, OBJ Palette Color 

GRE 

EN 

BLUE 

GREEN 

RED 


Note: The fifteenth bit is used as the iowest-order green bit. The iowest-order bits for biue and red are 
extended with a 0. 
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Other Graphics Function Data 



Texture Data 


FoSiiBS^ 

d 

15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 


4-color Texture 

16-color Texture 

256-color Texture 

A5I3 Translucent 
Texture 

A3I5 Translucent 
Texture 

Direct Color Texture 


ALPHA 


ALPHA 

GREEN 


INDEX 


INDEX 

RED 


Compressed Texture Data (Note: 32-bit notation) 
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Texture Palette Data 



15 

14 13 12 11 10 

9 

8 7 6 

5 

4 

3 2 1 

0 

Texture palette color 

- 

BLUE 

GREEN 

RED 


0AM Data 



Sound Data 



15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

0 

PCM 8 bit 









Data 0 

PCM16 bit 

Data 0 

ADPCM 













Data 0 
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All company and product names included in this document are the trademarks or registered trademarks of 
their respective companies. 


TWL-06-0017-001-D 
Released: February 16, 2009 


426 


© 2008-2009 Nintendo 
CONFIDENTIAL 



